esc
Loading...
to navigate
to select
API reference

Public transport

Find stops near a coordinate and resolve the lines that serve each stop.

GET /api/v1/public_transport_stops/nearby.json?latitude=40.7306&longitude=-73.9352&radius=1

Returns stops near a coordinate, ordered by distance, with details for their lines.

Query parameters

Name Type Required Description
latitude number Yes Origin latitude.
longitude number Yes Origin longitude.
radius integer No Radius in miles. Defaults to 1.
limit integer No Maximum records. Defaults to 20.
transport_type string No Filter by subway, bus, citi_bike, railroad, or ferry.
city_uuids[] / city_names[] array No Filter by cities.

Example request

curl --get 'https://hoodsdk.com/api/v1/public_transport_stops/nearby.json?latitude=40.7306&longitude=-73.9352&radius=1'

Example response 200 OK

[
  {
    "id": 9,
    "name": "Greenpoint Av",
    "latitude": 40.7314,
    "longitude": -73.9544,
    "transport_type": "subway",
    "lines": ["G"],
    "lines_details": [{"public_id": "G", "name": "G", "transport_type": "subway"}],
    "distance": 0.3
  }
]
GET /api/v1/public_transport_stops/closest.json?latitude=40.7306&longitude=-73.9352

Returns a representative set of the closest stops across transport modes, deduplicated by line and sorted by distance.

Subway, bus, and bike use radius. Railroad and ferry use their larger mode-specific radii.

Query parameters

Name Type Required Description
latitude number Yes Origin latitude.
longitude number Yes Origin longitude.
radius integer No Subway, bus, and bike radius in miles. Defaults to 1.
railroad_radius integer No Railroad radius. Defaults to radius + 3.
ferry_radius integer No Ferry radius. Defaults to radius + 3.
city_uuids[] / city_names[] array No Filter by cities.

Example request

curl --get 'https://hoodsdk.com/api/v1/public_transport_stops/closest.json?latitude=40.7306&longitude=-73.9352'

Example response 200 OK

[
  {
    "id": 9,
    "name": "Greenpoint Av",
    "latitude": 40.7314,
    "longitude": -73.9544,
    "transport_type": "subway",
    "lines": ["G"],
    "lines_details": [{"public_id": "G", "name": "G", "transport_type": "subway"}],
    "distance": 0.3
  }
]