Warning

This documentation covers a service that is currently in public beta. While we make a reasonable effort to ensure that things stay online, our beta services are not subject to the same availability guarantees of our other services. Additionally, beta services may not have the same global redundancy as our other services, so latency may be higher.

You will not be charged for beta access. If you continue using the service once it goes live, you will be charged as usual per the terms of our public pricing or your enterprise agreement.

Please send any feedback and issue reports to betafeedback@stadiamaps.com.

Place Lookup¶

Free

Starter

Standard

Professional

Most components of each geocoding response include a unique identifier in the form of a gid. For example, if you search for an address, you may want to find out more about the localadmin. You can get more information by looking up the result's localadmin_gid with the place endpoint.

Endpoint: https://api.stadiamaps.com/geocoding/v1/place

Query String Parameters¶

Parameter	Type	Required	Description	Default	Example
`ids`	comma-delimited string array	yes	A list of Pelias GIDs to search for.	none	`whosonfirst:borough:421205771`

Notes and tips¶

Not all types of data have searchable GIDs. For example, interpolated addresses are derived data and are not searchable (but other attributes of the response, such as the localadmin and region generally will). Specifically, only GIDs of type osm, oa, gn, wof, openaddresses, openstreetmap, geonames, whosonfirst are searchable.
Some sources do not guarantee stability of IDs over time, so caching them may lead to unexpected results. In general, Geonames and Who's on First are more curated and try to ensure IDs remain stable, but OpenAddresses and OpenStreetMap IDs are inherently unstable.

Response format¶

All geocoding, autocomplete, and search endpoints share a common response format. See the response format documentation for details. This endpoint will likely be extended in the future.