BTS National Transportation Atlas data contract

Provenance

PublisherBTS National Transportation Atlas

API basehttps://services.arcgis.com/xOi1kZaI0eWDREZv/arcgis/rest/services

Freshness & coverage

FreshnessFreshness not declared

GeographicNot declared

TemporalNot declared

AuthenticationNo credentials required

Methods (6)

searchRailLines

read

North American rail network. Filters: owner, state, county FIPS, bbox, passenger.

Input schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "owner": {
      "type": "string",
      "examples": [
        "BNSF"
      ]
    },
    "state": {
      "type": "string",
      "examples": [
        "TX"
      ]
    },
    "county": {
      "type": "string"
    },
    "passenger": {
      "type": "boolean"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}

owner is RROWNER1 code (BNSF/UP/CSXT/NS/CN/CPKC). Use bbox + state for slicing.

searchPorts

read

DIPT principal ports — vessel calls + tonnage by state, coast region, bbox.

Input schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "state": {
      "type": "string"
    },
    "coastRegion": {
      "type": "string",
      "examples": [
        "Gulf"
      ]
    },
    "minTonnage": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}

coastRegion: Atlantic, Gulf, Pacific, Great Lakes, Inland. Sorted by tonnage.

searchLocksAndDams

read

NID dams. Default returns lock-bearing subset. Filters: state, bbox, owner type.

Input schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "state": {
      "type": "string",
      "examples": [
        "LA"
      ]
    },
    "county": {
      "type": "string"
    },
    "withLocksOnly": {
      "type": "boolean"
    },
    "ownerType": {
      "type": "string"
    },
    "minHeight": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}

State accepts code or full name. Pass withLocksOnly=false for all ~92K dams.

searchAirports

read

FAA aviation facilities. Filters: state, county, siteType, facilityUse, status, arptId.

Input schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "state": {
      "type": "string",
      "examples": [
        "TX"
      ]
    },
    "county": {
      "type": "string"
    },
    "siteType": {
      "type": "string",
      "examples": [
        "A"
      ]
    },
    "facilityUse": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "arptId": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}

siteType: A=Airport, H=Heliport, C=Seaplane, U=Ultralight, G=Glider, B=Balloon.

searchIntermodalTerminals

read

Pipeline / liquid-bulk / rail-TOFC-COFC / marine-RoRo terminals. Pass terminalType.

Input schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "state": {
      "type": "string"
    },
    "terminalType": {
      "type": "string",
      "examples": [
        "pipeline"
      ],
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "pipeline"
          ]
        },
        {
          "type": "string",
          "enum": [
            "liquid-bulk"
          ]
        },
        {
          "type": "string",
          "enum": [
            "rail-tofc-cofc"
          ]
        },
        {
          "type": "string",
          "enum": [
            "marine-roro"
          ]
        }
      ]
    },
    "crudeOnly": {
      "type": "boolean",
      "examples": [
        true
      ]
    },
    "refinedOnly": {
      "type": "boolean"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}

crudeOnly + refinedOnly apply only to terminalType=pipeline (Y/N/NA values).

getServiceInfo

read

Schema + record counts for the 8 curated services. Pass service to scope.

Input schema

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "examples": [
        "rail"
      ],
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "rail"
          ]
        },
        {
          "type": "string",
          "enum": [
            "ports"
          ]
        },
        {
          "type": "string",
          "enum": [
            "damsLocks"
          ]
        },
        {
          "type": "string",
          "enum": [
            "airports"
          ]
        },
        {
          "type": "string",
          "enum": [
            "intermodalPipeline"
          ]
        },
        {
          "type": "string",
          "enum": [
            "intermodalLiquid"
          ]
        },
        {
          "type": "string",
          "enum": [
            "intermodalRail"
          ]
        },
        {
          "type": "string",
          "enum": [
            "intermodalRoro"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}