v1

latestOpenAPI 3.0.22026-07-132450182.6 KB
Surface Obstacles

Retrieve obstacles within given distance of location.

Retrieve obstacles within given distance of a point. Request body parameters are:

  • latitude: WGS84 latitude coordinate of your selected point, in decimal degrees
  • longitude: WGS84 longitude coordinate of your selected point, in decimal degrees
  • distance: distance in meters (max allowed value is 25000)
post/us/v1/obstacles/distance-query

Headers

x-api-keystring

Request body

Example request

{
  "longitude": -79.96,
  "latitude": 40.23,
  "distance": 1500
}

Response

A GeoJSON FeatureCollection, one Feature for each obstacle found.

foundobject required

Example response

{
  "found": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            -79.963714,
            40.220953
          ]
        },
        "properties": {
          "name": "MONONGAHELA-PA-025677",
          "obstacle_type": "CATENARY",
          "quantity": 1,
          "height_ft": 212,
          "lighting": "None",
          "marking": "Spherical Marker"
        }
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            -79.963137,
            40.22185
          ]
        },
        "properties": {
          "name": "MONONGAHELA-PA-020575",
          "obstacle_type": "CATENARY",
          "quantity": 1,
          "height_ft": 220,
          "lighting": "None",
          "marking": "Spherical Marker"
        }
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            -79.956389,
            40.224167
          ]
        },
        "properties": {
          "name": "MONONGAHELA-PA-000366",
          "obstacle_type": "T-L TWR",
          "quantity": 1,
          "height_ft": 141,
          "lighting": "None",
          "marking": "None"
        }
      }
    ]
  }
}