Geoserve Layers Endpoint

Request

Syntax

A geoserve places search takes the following form:

  https://earthquake.usgs.gov/ws/geoserve/layers.json?{parameters}

Parameters

Required Search Parameters

• type Enumeration
  Name of layer.

  anss

  Subset of the authoritative layer, including only Advanced National Seismic System (ANSS) contributors.

  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.

  tectonic

  Tectonic regions with corresponding descriptions.

Notes

Response

The response is formatted as a GeoJSON FeatureCollections nested in a top-level response object. The 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:

Authoritative (and ANSS)

• 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.

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.

• All regions in the anss layer:

  https://earthquake.usgs.gov/ws/geoserve/layers.json?type=anss

• All regions in the neicresponse layer:

  https://earthquake.usgs.gov/ws/geoserve/layers.json?type=neicresponse