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
andregion
generally will). Specifically, only GIDs of typeosm
,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.