Place Details API
The API is used to query additional information about the place or location. Together with information the result may contain place geometry (for example, building geometry) and records about place surroundings. The API is implemented via HTTP Get request.
API URL
https://api.geoapify.com/v2/place-details
Request parameters
| Name | Description |
|---|---|
| id | Place unique identifier that was returned by Geoapify Places API or Geoapify Geocoding API |
| lat | Latitude of a location. As alternative to "id" parameter, to get information about the location. |
| lon | Longitude of a location. As alternative to "id" parameter, to get information about the location. |
| features | Comma-separated list of the features. The "details" feature is returned when is not specified. |
| lang | Result language. 2-character ISO 639-1 language codes are supported. |
| apiKey | Required parameter for API key |
Response Object
The response returned contains a GeoJSON FeatureCollection object. Features may have different Geometry types - Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon. Depending on feature type features may have different properties objects. Each feature has the following properties that allow identifying the feature:
| Name | Description |
|---|---|
| feature_type | Type of the feature |
Learn about properties available in the features in the appropriate feature specification.
Features
You can request one or multiple features per Place Details API request.
Note! When "features" parameter is not specified for a request with a place id, the "details" feature is returned by default.
| Feature ID | Result type | Description |
|---|---|---|
details |
Details feature | Details and geometry for the place |
details.population |
Details feature | Adds population by years information. Costs an additional request. Need to be added explicitly. |
details.names |
Details feature | Adds international names. Costs an additional request. Need to be added explicitly. |
details.full_geometry |
Details feature | Returns original geometry. Costs an additional request. Need to be added explicitly. |
building |
Details feature | The API looks for a building where the specified place is located or by coordinates and returns details and geometry for the building |
building.places |
Array of Place feature | Places of "commercial", "accommodation", "sport", "service", "rental", "healthcare", "childcare", "entertainment", "catering" categories located in the building found by the given place Id or coordinates |
building.commercial |
Array of Place feature | Places of "commercial" category located in the building found by the given place Id or coordinates |
building.catering |
Array of Place feature | Places of "catering" category located in the building found by the given place Id or coordinates |
radius_100 |
Geometry feature | Circle with a radius of 100 m from the specified place |
radius_100.supermarket |
Array of Place feature | Places of "commercial.supermarket" category within the geometry |
radius_100.restaurant |
Array of Place feature | Places of "catering.restaurant", "catering.fast_food", "catering.food_court" categories within the geometry |
radius_100.cafe |
Array of Place feature | Places of "commercial.cafe" category within the geometry |
radius_100.toilet |
Array of Place feature | Places of "amenity.toilet" category within the geometry |
radius_500 |
Geometry feature | Circle with a radius of 500 m from the specified place |
radius_500.supermarket |
Array of Place feature | Places of "commercial.supermarket" category within the geometry |
radius_500.shopping_mall |
Array of Place feature | Places of "commercial.shopping_mall" category within the geometry |
radius_500.tourism |
Array of Place feature | Places of "tourism" category within the geometry |
radius_500.restaurant |
Array of Place feature | Places of "catering.restaurant", "catering.fast_food", "catering.food_court" categories within the geometry |
radius_500.cafe |
Array of Place feature | Places of "commercial.cafe" category within the geometry |
radius_500.school |
Array of Place feature | Places of "education.school" category within the geometry |
radius_500.toilet |
Array of Place feature | Places of "amenity.toilet" category within the geometry |
radius_500.hotel |
Array of Place feature | Places of "accommodation.hotel", "accommodation.guest_house" categories within the geometry |
radius_500.playground |
Array of Place feature | Places of "leisure.playground" category within the geometry |
radius_500.atm |
Array of Place feature | Places of service.financial.atm category within the geometry |
radius_1000 |
Geometry feature | Circle with a radius of 1000 m from the specified place |
radius_1000.supermarket |
Array of Place feature | Places of "commercial.supermarket" category within the geometry |
radius_1000.shopping_mall |
Array of Place feature | Places of "commercial.shopping_mall" category within the geometry |
radius_1000.tourism |
Array of Place feature | Places of "tourism" category within the geometry |
radius_1000.restaurant |
Array of Place feature | Places of "catering.restaurant", "catering.fast_food", "catering.food_court" categories within the geometry |
radius_1000.cafe |
Array of Place feature | Places of "commercial.cafe" category within the geometry |
radius_1000.school |
Array of Place feature | Places of "education.school" category within the geometry |
radius_1000.toilet |
Array of Place feature | Places of "amenity.toilet" category within the geometry |
radius_1000.hotel |
Array of Place feature | Places of "accommodation.hotel", "accommodation.guest_house" categories within the geometry |
radius_1000.playground |
Array of Place feature | Places of "leisure.playground" category within the geometry |
radius_1000.atm |
Array of Place feature | Places of "service.financial.atm" category within the geometry |
radius_1000.park |
Array of Place feature | Places of "leisure.park" category within the geometry |
radius_1000.pharmacy |
Array of Place feature | Places of "healthcare.pharmacy" category within the geometry |
radius_1000.entertainment |
Array of Place feature | Places of "entertainment" category within the geometry |
walk_5 |
Geometry feature | Reachability contour/isochrone within 5 minutes walking |
walk_5.supermarket |
Array of Place feature | Places of "commercial.supermarket" category within the geometry |
walk_5.shopping_mall |
Array of Place feature | Places of "commercial.shopping_mall" category within the geometry |
walk_5.tourism |
Array of Place feature | Places of "tourism" category within the geometry |
walk_5.restaurant |
Array of Place feature | Places of "catering.restaurant", "catering.fast_food", "catering.food_court" categories within the geometry |
walk_5.cafe |
Array of Place feature | Places of "commercial.cafe" category within the geometry |
walk_5.school |
Array of Place feature | Places of "education.school" category within the geometry |
walk_5.toilet |
Array of Place feature | Places of "amenity.toilet" category within the geometry |
walk_5.hotel |
Array of Place feature | Places of "accommodation.hotel", "accommodation.guest_house" categories within the geometry |
walk_5.playground |
Array of Place feature | Places of "leisure.playground" category within the geometry |
walk_5.atm |
Array of Place feature | Places of "service.financial.atm" category within the geometry |
walk_10 |
Geometry feature | Reachability contour/isochrone within 10 minutes walking |
walk_10.supermarket |
Array of Place feature | Places of "commercial.supermarket" category within the geometry |
walk_10.shopping_mall |
Array of Place feature | Places of "commercial.shopping_mall" category within the geometry |
walk_10.tourism |
Array of Place feature | Places of "tourism" category within the geometry |
walk_10.restaurant |
Array of Place feature | Places of "catering.restaurant", "catering.fast_food", "catering.food_court" categories within the geometry |
walk_10.cafe |
Array of Place feature | Places of "commercial.cafe" category within the geometry |
walk_10.school |
Array of Place feature | Places of "education.school" category within the geometry |
walk_10.toilet |
Array of Place feature | Places of "amenity.toilet" category within the geometry |
walk_10.hotel |
Array of Place feature | Places of "accommodation.hotel", "accommodation.guest_house" categories within the geometry |
walk_10.playground |
Array of Place feature | Places of "leisure.playground" category within the geometry |
walk_10.atm |
Array of Place feature | Places of service.financial.atm category within the geometry |
walk_10.park |
Array of Place feature | Places of "leisure.park" category within the geometry |
walk_10.pharmacy |
Array of Place feature | Places of "healthcare.pharmacy" category within the geometry |
walk_10.entertainment |
Array of Place feature | Places of "entertainment" category within the geometry |
walk_15 |
Geometry feature | Reachability contour/isochrone within 15 minutes walking |
walk_15.supermarket |
Array of Place feature | Places of "commercial.supermarket" category within the geometry |
walk_15.shopping_mall |
Array of Place feature | Places of "commercial.shopping_mall" category within the geometry |
walk_15.tourism |
Array of Place feature | Places of "tourism" category within the geometry |
walk_15.restaurant |
Array of Place feature | Places of "catering.restaurant", "catering.fast_food", "catering.food_court" categories within the geometry |
walk_15.cafe |
Array of Place feature | Places of "commercial.cafe" category within the geometry |
walk_15.school |
Array of Place feature | Places of "education.school" category within the geometry |
walk_15.hotel |
Array of Place feature | Places of "accommodation.hotel", "accommodation.guest_house" categories within the geometry |
walk_15.playground |
Array of Place feature | Places of "leisure.playground" category within the geometry |
walk_15.atm |
Array of Place feature | Places of service.financial.atm category within the geometry |
walk_15.park |
Array of Place feature | Places of "leisure.park" category within the geometry |
walk_15.pharmacy |
Array of Place feature | Places of "healthcare.pharmacy" category within the geometry |
walk_15.entertainment |
Array of Place feature | Places of "entertainment" category within the geometry |
walk_30 |
Geometry feature | Reachability contour/isochrone within 30 minutes walking |
walk_30.supermarket |
Array of Place feature | Places of "commercial.supermarket" category within the geometry |
walk_30.shopping_mall |
Array of Place feature | Places of "commercial.shopping_mall" category within the geometry |
walk_30.tourism |
Array of Place feature | Places of "tourism" category within the geometry |
walk_30.restaurant |
Array of Place feature | Places of "catering.restaurant", "catering.fast_food", "catering.food_court" categories within the geometry |
walk_30.cafe |
Array of Place feature | Places of "commercial.cafe" category within the geometry |
walk_30.school |
Array of Place feature | Places of "education.school" category within the geometry |
walk_30.hotel |
Array of Place feature | Places of "accommodation.hotel", "accommodation.guest_house" categories within the geometry |
walk_30.playground |
Array of Place feature | Places of "leisure.playground" category within the geometry |
walk_30.atm |
Array of Place feature | Places of service.financial.atm category within the geometry |
walk_30.park |
Array of Place feature | Places of "leisure.park" category within the geometry |
walk_30.pharmacy |
Array of Place feature | Places of "healthcare.pharmacy" category within the geometry |
walk_30.entertainment |
Array of Place feature | Places of "entertainment" category within the geometry |
drive_5 |
Geometry feature | Reachability contour/isochrone within 5 minutes driving |
drive_5.supermarket |
Array of Place feature | Places of "commercial.supermarket" category within the geometry |
drive_5.shopping_mall |
Array of Place feature | Places of "commercial.shopping_mall" category within the geometry |
drive_5.tourism |
Array of Place feature | Places of "tourism" category within the geometry |
drive_5.restaurant |
Array of Place feature | Places of "catering.restaurant", "catering.fast_food", "catering.food_court" categories within the geometry |
drive_5.cafe |
Array of Place feature | Places of "commercial.cafe" category within the geometry |
drive_5.school |
Array of Place feature | Places of "education.school" category within the geometry |
drive_5.hotel |
Array of Place feature | Places of "accommodation.hotel", "accommodation.guest_house" categories within the geometry |
drive_5.playground |
Array of Place feature | Places of "leisure.playground" category within the geometry |
drive_5.atm |
Array of Place feature | Places of service.financial.atm category within the geometry |
drive_5.park |
Array of Place feature | Places of "leisure.park" category within the geometry |
drive_5.hospital |
Array of Place feature | Places of "healthcare.hospital" category within the geometry |
drive_5.pharmacy |
Array of Place feature | Places of "healthcare.pharmacy" category within the geometry |
drive_5.entertainment |
Array of Place feature | Places of "entertainment" category within the geometry |
drive_5.fuel |
Array of Place feature | Places of "service.vehicle.fuel" category within the geometry |
drive_5.charging_station |
Array of Place feature | Places of "service.vehicle.charging_station" category within the geometry |
drive_5.parking |
Array of Place feature | Places of "parking" category with "access" condition within the geometry |
drive_10 |
Geometry feature | Reachability contour/isochrone within 5 minutes driving |
drive_10.supermarket |
Array of Place feature | Places of "commercial.supermarket" category within the geometry |
drive_10.shopping_mall |
Array of Place feature | Places of "commercial.shopping_mall" category within the geometry |
drive_10.tourism |
Array of Place feature | Places of "tourism" category within the geometry |
drive_10.restaurant |
Array of Place feature | Places of "catering.restaurant", "catering.fast_food", "catering.food_court" categories within the geometry |
drive_10.cafe |
Array of Place feature | Places of "commercial.cafe" category within the geometry |
drive_10.school |
Array of Place feature | Places of "education.school" category within the geometry |
drive_10.hotel |
Array of Place feature | Places of "accommodation.hotel", "accommodation.guest_house" categories within the geometry |
drive_10.playground |
Array of Place feature | Places of "leisure.playground" category within the geometry |
drive_10.atm |
Array of Place feature | Places of service.financial.atm category within the geometry |
drive_10.park |
Array of Place feature | Places of "leisure.park" category within the geometry |
drive_10.hospital |
Array of Place feature | Places of "healthcare.hospital" category within the geometry |
drive_10.pharmacy |
Array of Place feature | Places of "healthcare.pharmacy" category within the geometry |
drive_10.entertainment |
Array of Place feature | Places of "entertainment" category within the geometry |
drive_10.fuel |
Array of Place feature | Places of "service.vehicle.fuel" category within the geometry |
drive_10.charging_station |
Array of Place feature | Places of "service.vehicle.charging_station" category within the geometry |
drive_10.parking |
Array of Place feature | Places of "parking" category with "access" condition within the geometry |
drive_15 |
Geometry feature | Reachability contour/isochrone within 5 minutes driving |
drive_15.supermarket |
Array of Place feature | Places of "commercial.supermarket" category within the geometry |
drive_15.shopping_mall |
Array of Place feature | Places of "commercial.shopping_mall" category within the geometry |
drive_15.tourism |
Array of Place feature | Places of "tourism" category within the geometry |
drive_15.restaurant |
Array of Place feature | Places of "catering.restaurant", "catering.fast_food", "catering.food_court" categories within the geometry |
drive_15.cafe |
Array of Place feature | Places of "commercial.cafe" category within the geometry |
drive_15.school |
Array of Place feature | Places of "education.school" category within the geometry |
drive_15.hotel |
Array of Place feature | Places of "accommodation.hotel", "accommodation.guest_house" categories within the geometry |
drive_15.playground |
Array of Place feature | Places of "leisure.playground" category within the geometry |
drive_15.atm |
Array of Place feature | Places of service.financial.atm category within the geometry |
drive_15.park |
Array of Place feature | Places of "leisure.park" category within the geometry |
drive_15.hospital |
Array of Place feature | Places of "healthcare.hospital" category within the geometry |
drive_15.pharmacy |
Array of Place feature | Places of "healthcare.pharmacy" category within the geometry |
drive_15.entertainment |
Array of Place feature | Places of "entertainment" category within the geometry |
drive_15.fuel |
Array of Place feature | Places of "service.vehicle.fuel" category within the geometry |
drive_15.charging_station |
Array of Place feature | Places of "service.vehicle.charging_station" category within the geometry |
drive_15.parking |
Array of Place feature | Places of "parking" category with "access" condition within the geometry |