Geoserve Regions Endpoint

Request

Syntax

  https://staging-earthquake.usgs.gov/ws/geoserve/regions.json?{parameters}

Parameters

Required Search Parameters

• latitude Number
  Latitude in decimal degrees of point. [-90, 90].
• longitude Number
  Longitude in decimal degrees of point. [-180, 180].

Optional Search Parameters

• includeGeometry Boolean
  Set to true returns poloygon points of the selected region. Default false.
• type Enumeration
  Region types. Comma-separated list.

  admin

  Global polygons for use in Geoserve are based on data from [http://www.gadm.org/](http://www.gadm.org/) version 2.0. The GADM data has been processed in GIS to only include the level 2 boundaries (state level). Originally these data contained boundaries to level 3 (county level), but current requirements did not need such granularity. This simplification enables faster queries.

  authoritative

  This dataset was created by the USGS/NEIC (B. Presgrave & P.Earle) to define the regions where using various seismic monitoring organization's earthquake solutions is either recommended (for international organizations) or required (for ANSS affiliated organizations).

  fe

  This dataset was created by Presgrave, B.W. to provide more specific region names when available. Like FE regions, these regions are also based on a 1x1 degree grid. Unlike the FE regions, no unique number was assigned to each region.

  neiccatalog

  This dataset was created by the USGS/NEIC (B. Presgrave & P.Earle) to define the polygon areas and threshold magnitudes at which the NEIC responds to and/or publishes an earthquake event to the public and/or NEIC event catalog.

  neicresponse

  This dataset was created by the USGS/NEIC (B. Presgrave & P.Earle) to define the polygon areas and threshold magnitudes at which the NEIC responds to and/or publishes an earthquake event to the public and/or NEIC event catalog.

  offshore

  This dataset is from the original FE Plus dataset and defines "offshore" regions where earthquakes are a common occurrence.

  tectonic

  Tectonic regions with corresponding descriptions.

Notes

Response

The response is formatted as one or more nested GeoJSON FeatureCollections. Each nested GeoJSON FeatureCollections is keyed by the request type.

Properties

Each returned Feature in the GeoJSON FeatureCollection includes an id, a geometry object with longitude, latitude, and elevation, and a properties object with the following attributes:

Admin

• country String
  Name of country.
• iso String
  Country code.
• region String
  Name of region.

Auth

• name String
  Name of contributor.
• network String
  Name of network.
• region String
  Name of network sub-region
• type String
  Type of authoritative region
• url String
  URL for more information

FE

• name String
  Name of FE region.
• num String
  FE region identification number.

NEIC Catalog

• magnitude String
  Magnitude associated with the place.
• name String
  NEIC catalog name.

NEIC Response

• magnitude String
  Magnitude associated with the place.
• name String
  NEIC catalog name.

Offshore

• name String
  Offshore region name.

Tectonic Summary

• name String
  Tectonic summary region name.
• summary String
  Tectonic summary content.
• type String
  Tectonic summary type.

Examples

Below are example requests and responses that detail the nested GeoJSON structure. Each type has a nested GeoJSON FeatureCollection that may contain multiple GeoJSON features. Click the link for an example to see the response.

• Region search at latitude 39.5, longitude -105:

  https://staging-earthquake.usgs.gov/ws/geoserve/regions.json?latitude=39.5&longitude=-105

• Region search at latitude 39.5, longitude -105, includeGeometry set to true:

  https://staging-earthquake.usgs.gov/ws/geoserve/regions.json?latitude=39.5&longitude=-105&includeGeometry=true

• Region search at latitude 39.5, longitude -105, type set to fe:

  https://staging-earthquake.usgs.gov/ws/geoserve/regions.json?latitude=39.5&longitude=-105&type=fe