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