Get Place Hierarchies
Get the list of hierarchies for a Place.
This endpoint is in Beta.
The currently available filters and response data change are subject to change.
This endpoint allows you to get the full place hierarchies for
a given coordinate
list of
place_id
.
A place hierarchy is a list of place identifiers and types from the planet
level down to the level
specified in your query (please note that level
defaults to locality
if not specified in your query).
The response might include more than one hierarchy for a given coordinate. The reason for this is that we try to match the closest place's hierarchy but we also include the closest major city's hierarchy within a radius of 50km. This only applies if the level
is below region
and, if it exists, the major city's hierarchy will always be the second item in the list.
For instance, if you specify ?location.origin=47.615337,-122.203981
, which is a coordinate located in Bellevue, Washington, you'll get two hierarchies, one for Bellevue but also one for Seattle.
Request
HTTP Request
Query Parameters
country
string
location.origin
coordinate
A coordinate in the form {latitude},{longitude}
.
Please note that you must specify either location.origin
or location.place_id
in your request.
E.g. ?location.origin=47.615337,-122.203981
location.place_id
string
A list of place_id
in the form {place_id1},{place_id2},...
.
Please note that you must specify either location.origin
or location.place_id
in your request.
E.g. ?location.place_id=5809844,6252001
level
string
A place level. Possible values:
neighbourhood
locality
localadmin
county
region
country
continent
planet
Defaults to locality
.
E.g. ?level=county
Response
Examples
Guides
Below are some guides relevant to this API:
Last updated