Sign up
All data sources

USGS Elevation Services

Unknown authusgs-elevation

USGS Elevation Point Query Service (EPQS), 3D Elevation Program (3DEP), and topographic CONTOUR LINES. Get elevation at points, batch elevation queries, elevation profiles along routes, and topo contour-line vector data (GeoJSON) for rendering on a map. CRITICAL USAGE RULES: 1. No authentication required 2. Use getElevation() for single point elevation 3. Use getElevationProfile() for pipeline route terrain analysis 4. Use getContoursGeoJSON() for topographic contour LINES — requires a bbox or near (lat/lon) because contour data is dense; pass the result to patchops_addMapLayer to draw them 5. Units: 'Feet' or 'Meters' (default Feet)

Get this contract as JSONConnect this source →

Provenance

PublisherUSGS Elevation Services

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationNo credentials required

Methods (5)

  • getElevation

    read

    Retrieve elevation at one coordinate in requested units.

    Input schema
    {
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number"
    },
    "longitude": {
      "type": "number"
    },
    "units": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "Feet"
          ]
        },
        {
          "type": "string",
          "enum": [
            "Meters"
          ]
        }
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "latitude",
    "longitude"
  ]
}

  • getElevations

    read

    Retrieve elevations for multiple coordinate points in requested units.

    Input schema
    {
  "type": "object",
  "properties": {
    "points": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number"
          },
          "longitude": {
            "type": "number"
          }
        },
        "required": [
          "latitude",
          "longitude"
        ],
        "additionalProperties": false
      }
    },
    "units": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "Feet"
          ]
        },
        {
          "type": "string",
          "enum": [
            "Meters"
          ]
        }
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "points"
  ]
}

  • query3DEPCoverage

    unknown

    Query three-dimensional elevation coverage data at one coordinate.

    Input schema
    {
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number"
    },
    "longitude": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "required": [
    "latitude",
    "longitude"
  ]
}

  • getElevationProfile

    read

    Retrieve an elevation profile between two coordinates with configurable samples and units.

    Input schema
    {
  "type": "object",
  "properties": {
    "startLat": {
      "type": "number"
    },
    "startLon": {
      "type": "number"
    },
    "endLat": {
      "type": "number"
    },
    "endLon": {
      "type": "number"
    },
    "numSamples": {
      "type": "number"
    },
    "units": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "Feet"
          ]
        },
        {
          "type": "string",
          "enum": [
            "Meters"
          ]
        }
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "startLat",
    "startLon",
    "endLat",
    "endLon"
  ]
}

  • getContoursGeoJSON

    read

    Retrieve elevation contour GeoJSON by bounding box, nearby location, elevation range, or contour type.

    Input schema
    {
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "near": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lon": {
          "type": "number"
        },
        "radiusMiles": {
          "type": "number"
        }
      },
      "required": [
        "lat",
        "lon",
        "radiusMiles"
      ],
      "additionalProperties": false
    },
    "latitude": {
      "type": "number"
    },
    "longitude": {
      "type": "number"
    },
    "radius_meters": {
      "type": "number"
    },
    "contour_type": {
      "type": "string"
    },
    "min_elevation": {
      "type": "number"
    },
    "max_elevation": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false
}