USGS Earthquake Hazards (Independent Publisher) (Preview)
The United States Geological Survey (USGS) monitors and reports on earthquakes, assesses earthquake impacts and hazards, and conducts targeted research on the causes and effects of earthquakes. USGS undertakes these activities as part of the larger National Earthquake Hazards Reduction Program (NEHRP), a four-agency partnership established by Congress.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| ttaylor@hitachisolutions.com |
| Connector Metadata | |
|---|---|
| Publisher | Troy Taylor |
| Website | https://earthquake.usgs.gov/ |
| Privacy policy | https://www.usgs.gov/policies-and-notices |
| Categories | Data |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Get earthquake information |
Retrieves a list of earthquake information based on the supplied parameters. |
Get earthquake information
Retrieves a list of earthquake information based on the supplied parameters.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
End Time
|
endtime | string |
Limit to events on or before the specified end time. NOTE: All times use ISO8601 Date/Time format. Unless a timezone is specified, UTC is assumed. |
|
|
Start Time
|
starttime | string |
Limit to events on or after the specified start time. NOTE: All times use ISO8601 Date/Time format. Unless a timezone is specified, UTC is assumed. |
|
|
Updated After
|
updatedafter | string |
Limit to events updated after the specified time. NOTE: All times use ISO8601 Date/Time format. Unless a timezone is specified, UTC is assumed. |
|
|
Min Latitude
|
minlatitude | number |
Limit to events with a latitude larger than the specified minimum. NOTE: min values must be less than max values. |
|
|
Min Longitude
|
minlongitude | number |
Limit to events with a longitude larger than the specified minimum. NOTE: rectangles may cross the date line by using a min longitude < -180 or max longitude > 180. NOTE: min values must be less than max values. |
|
|
Max Latitude
|
maxlatitude | number |
Limit to events with a latitude smaller than the specified maximum. NOTE: min values must be less than max values. |
|
|
Max Longitude
|
maxlongitude | number |
Limit to events with a longitude smaller than the specified maximum. NOTE: rectangles may cross the date line by using a min longitude < -180 or max longitude > 180. NOTE: min values must be less than max values. |
|
|
Latitude
|
latitude | number |
Specify the latitude to be used for a radius search. |
|
|
Longitude
|
longitude | number |
Specify the longitude to be used for a radius search. |
|
|
Max Radius
|
maxradius | number |
Limit to events within the specified maximum number of degrees from the geographic point defined by the latitude and longitude parameters. NOTE: This option is mutually exclusive with max radius KM and specifying both will result in an error. |
|
|
Max Radius KM
|
maxradiuskm | number |
Limit to events within the specified maximum number of kilometers from the geographic point defined by the latitude and longitude parameters. NOTE: This option is mutually exclusive with max radius and specifying both will result in an error. |
|
|
Catalog
|
catalog | string |
Limit to events from a specified catalog. |
|
|
Contributor
|
contributor | string |
Limit to events contributed by a specified contributor. |
|
|
Event ID
|
eventid | string |
Select a specific event by ID; event identifiers are data center specific. |
|
|
Include All Magnitudes
|
includeallmagnitudes | boolean |
Specify if all magnitudes for the event should be included, default is data center dependent but is suggested to be the preferred magnitude only. |
|
|
Include All Origins
|
includeallorigins | boolean |
Specify if all origins for the event should be included, default is data center dependent but is suggested to be the preferred origin only. |
|
|
Include Deleted
|
includedeleted | boolean |
Specify if deleted products and events should be included. The value only returns only deleted events. |
|
|
Include Superseded
|
includesuperseded | boolean |
Specify if superseded products should be included. This also includes all deleted products, and is mutually exclusive to the include deleted parameter. NOTE: Only works when specifying event ID parameter. |
|
|
Max Depth
|
maxdepth | number |
Limit to events with depth less than the specified maximum. |
|
|
Max Magnitude
|
maxmagnitude | number |
Limit to events with a magnitude smaller than the specified maximum. |
|
|
Min Depth
|
mindepth | number |
Limit to events with depth more than the specified minimum. |
|
|
Min Magnitude
|
minmagnitude | number |
Limit to events with a magnitude larger than the specified minimum. |
|
|
Alert Level
|
alertlevel | string |
Limit to events with a specific PAGER alert level. |
|
|
Event Type
|
eventtype | string |
Limit to events of a specific type. NOTE: “earthquake” will filter non-earthquake events. |
|
|
Max CDI
|
maxcdi | number |
Maximum value for Maximum Community Determined Intensity reported by DYFI. |
|
|
Max Gap
|
maxgap | number |
Limit to events with no more than this azimuthal gap. |
|
|
Max MMI
|
maxmmi | number |
Maximum value for Maximum Modified Mercalli Intensity reported by ShakeMap. |
|
|
Max significance
|
maxsig | integer |
Limit to events with no more than this significance. |
|
|
Min CDI
|
mincdi | number |
Minimum value for Maximum Community Determined Intensity reported by DYFI. |
|
|
Min Felt
|
minfelt | integer |
Limit to events with this many DYFI responses. |
|
|
Min Gap
|
mingap | number |
Limit to events with no less than this azimuthal gap. |
|
|
Min SIG
|
minsig | integer |
Limit to events with no less than this significance. |
|
|
Product Type
|
producttype | string |
Limit to events that have this type of product associated |
|
|
Product Code
|
productcode | string |
Return the event that is associated with the productcode. The event will be returned even if the productcode is not the preferred code for the event. |
|
|
Review Status
|
reviewstatus | string |
Limit to events with a specific review status. |
|
|
Limit
|
limit | integer |
Limit the results to the specified number of events. NOTE: The service limits queries to 20000, and any that exceed this limit will generate a HTTP response code “400 Bad Request”. |
|
|
Offset
|
offset | integer |
Return results starting at the event count specified, starting at 1. |
|
|
Order By
|
orderby | string |
Order the results. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Type
|
type | string |
The type. |
|
Generated
|
metadata.generated | integer |
The number generated. |
|
URL
|
metadata.url | string |
The URL address. |
|
Title
|
metadata.title | string |
The title. |
|
Status
|
metadata.status | integer |
The status. |
|
API
|
metadata.api | string |
The API. |
|
Count
|
metadata.count | integer |
The count. |
|
Features
|
features | array of object | |
|
Type
|
features.type | string |
The type. |
|
Magnitude
|
features.properties.mag | float |
The magnitude. |
|
Place
|
features.properties.place | string |
The place. |
|
Time
|
features.properties.time | integer |
The time. |
|
Updated
|
features.properties.updated | integer |
The number of times updated. |
|
Time Zone
|
features.properties.tz | string |
The time zone. |
|
URL
|
features.properties.url | string |
The URL address. |
|
Detail
|
features.properties.detail | string |
The detail. |
|
Felt
|
features.properties.felt | integer |
The felt. |
|
CDI
|
features.properties.cdi | float |
The maximum community determined. |
|
MMI
|
features.properties.mmi | float |
The maximum modified Mercalli intensity. |
|
Alert
|
features.properties.alert | string |
The alert. |
|
Status
|
features.properties.status | string |
The status. |
|
Tsunami
|
features.properties.tsunami | integer |
The number of tsunami. |
|
Sig
|
features.properties.sig | integer |
The significance. |
|
Net
|
features.properties.net | string |
The net. |
|
Code
|
features.properties.code | string |
The code. |
|
IDs
|
features.properties.ids | string |
The identifiers. |
|
Sources
|
features.properties.sources | string |
The sources. |
|
Types
|
features.properties.types | string |
The types. |
|
NST
|
features.properties.nst | integer |
The number of seismic stations which reported P- and S-arrival times for this earthquake. |
|
DMIN
|
features.properties.dmin | number |
The horizontal distance from the epicenter to the nearest station (in degrees). |
|
RMS
|
features.properties.rms | float |
The root-mean-square travel time residual, in seconds, using all weights. |
|
Gap
|
features.properties.gap | float |
The gap. |
|
Mag Type
|
features.properties.magType | string |
The magnitude type. |
|
Type
|
features.properties.type | string |
The type. |
|
Title
|
features.properties.title | string |
The title. |
|
Type
|
features.geometry.type | string |
The title. |
|
Coordinates
|
features.geometry.coordinates | array of float |
The coordinates. |
|
ID
|
features.id | string |
The identifier. |
|
Boundary Box
|
bbox | array of float |
The boundary box. |