Data API
PlaygroundDashboardWebsite

Coverage and data

Where the API works, which data sources and licences it uses, the Data Release cadence, and known gaps.

Coverage Area

United States and Canada. For geocoding, other countries return an empty result set with HTTP 200.

Data sources

Used forSource
Base map, places, routing graphOpenStreetMap (Geofabrik US and Canada extracts), ODbL
US addressesUSDOT National Address Database (NAD)
Canadian addressesStatCan National Address Register (NAR)
Addresses (both countries)Overture Maps addresses
US street interpolationCensus TIGER (via Nominatim)
US postcodesCensus ZCTA5
Canadian postcodesStatCan FSA boundaries; full 6-character codes from NAR-derived points
Timezonestimezone-boundary-builder 2026f, with tzdb 2026f
ElevationTilezen skadi tiles

Address Point results carry the source and licence in datasource (see Concepts).

Data Release

The first national Data Release is 20261102-a (built 2026-11-02; deploy to production was still pending when this was written). Releases are full rebuilds on a monthly cadence (ADR 0004), so data is frozen between releases and Place IDs stay stable while the underlying thing exists.

Known gaps

  • ZCTA is not a USPS ZIP. US postcodes come from Census ZCTA5 polygons. PO-box-only ZIPs have no polygon.

  • Special postcodes are absent. Codes like K1A 0B1 are not in the data.

  • Empty boundary types. /boundaries/part-of has data layers for administrative, postal_code, timezone (timezone-boundary-builder) and OSM polygons (neighborhood, place, region, political, historic, protected_area, national_park, aboriginal_lands, census, school_district, forest, hazard, regional_park, religious_administration, low_emission_zone, public_transport, traditional). Only religious, municipality, barony, town, health and historic:administrative are empty. /boundaries/consists-of has data for administrative and postal_code only.

  • Territories. Puerto Rico and other US territories are not confirmed in coverage. During the build, Overture codes PR, GU, VI, AS and MP as separate countries and those rows were dropped, and Overture has no Hawaii or New Hampshire rows (see docs/handoff/16-RESUME.md). Test your area before relying on it.

  • Fields never returned. Examples: isoline details=population, mapmatching lookup_step_osmtags and lookup_osm_overlap. Each endpoint page lists its own.

  • Traffic. The traffic parameter is accepted and ignored; durations are free-flow.

Performance

Phase 14 load test (docs/handoff/14-load-test.md), 16 concurrent clients on the Mac Studio against the Indiana and Prince Edward Island Dev Extract. These are not production numbers; the document says the national re-run is the one that counts.

EndpointRequests per secondp95 (ms)
geocode/search (cold)364116.8
geocode/autocomplete112330.4
geocode/reverse43958.4
routing33086.9
routematrix (3x3)90311
isoline58474
postcode/search74392.5
timezone120517.5

Isoline and matrix dominate latency (Valhalla compute).

Concepts

Place IDs, rank, datasource, the error shape, response formats and how this API differs from Geoapify.

Forward geocoding

Turn an address or place name into coordinates and a structured address for the United States and Canada.

On this page

Coverage AreaData sourcesData ReleaseKnown gapsPerformance