Place Details API - Get Location Details, Discover Important Info About Any Place or Building
Get contact data, opening times, website, or geometry for any building or location with Place Details API. Learn more about the building where the place is located and its surroundings. Click on someplace on the map to get location details, try to switch between different features and see points of interest reachable from the place.
Place Details API allows to query details for a place returned by Geocoding API or Places API as well as information for a location by coordinates. The API supports a number of features, that let you obtain different aspects about the place and rank the place.
Get an API key and start using the API for Free with our Freemium pricing model! Try more options in the Playground!
Data available with Place Details API
We use Features to organize and structure data. Query the data you need!
Different Features and their properties are responsible for different information aspects. In the table, you can see features examples available with Place Details API. See the list of existing Features >>
| Feature | Description |
|---|---|
details | Returns information available about the place - names, website, contact data, opening hours, facilities, restrictions, category related data (for example, parking capacity or restaurant cuisine type). Check the full list here >> |
building, building.places, building.commercial, building.catering | Return information about the building where the place is located. Additionally, with building.places, building.commercial and other features you can query places located in the same building. |
radius_100, radius_100.supermarket, radius_500.shopping_mall, radius_500.atm, ... | Return places and points of interest located within a specified radius from the place. |
walk_5.cafe, walk_10.supermarket, walk_15.hotel, drive_5.fuel, drive_5.parking, ... | Return places and points of interest reachable from the place. For example, drive_5.fuel gives a 5 minutes drive isochrone geometry and all Fuel stations within the geometry. |
The supported Feature list is constantly growing. Contact us when you require a Feature that is not present yet in the list.
Use cases and examples - Learn how can your business benefit using Place Details API
Tell more about the place
Depending on the type of amenity the Place Details API provides different information that can be useful for your customers. For example, location details for a restaurant can include:
- Opening hours
- Contact data and website
- Type of cuisine
- Payment methods
Furthermore, you can offer more useful data with neighborhood features. For instance, the "drive_5.parking" feature shows parking options near the amenity.
More information about building and amenities located there
Place Detail API lets to extract information about a building that located in the specified location or contains the given place. Here is an example of data that can be returned for a building:
- Building geometry, area
- Building characteristics - number of levels, type of roof, architecture information
- Infrastructure and objects within the building
You can query specific building amenities by using different features. For example, the "building.catering" feature returns all restaurants, cafes, bars located in the building.
Show regions and statistical data
Place Details API can return boundaries and statistical data for regions. For example, when you query details for a city the result contains the city boundaries and population statistics.
Contact us when you need some specific data for regions and populated places.
Place Details API tutorials
Check out our tutorials to make it easy to get started and get the results you want with Place Details API:
Boosting Business Visibility: OpenStreetMap for Local Marketing
How did we create a thematic map of ski resorts
OpenStreetMap as geodata source
How Much Does It Cost To Use the Geoapify Place Details API?
Geoapify uses a credit-based system for pricing its Place Details API, enabling access to detailed information about places. The number of credits consumed depends on the specific data requested and the API usage.
- One credit is consumed for each detailed place data request made through the API.
To meet the needs of different users, Geoapify offers multiple pricing plans with varying credit allowances and features. For more details, check out our Pricing page.
If you’re new to the API, our Free Plan includes 3000 credits per day, perfect for exploring the Place Details API or conducting small-scale projects at no cost.
Examples of Credit Usage:
- Example 1: Retrieving details for 100 places will consume 100 credits (1 credit per place).
- Example 2: Accessing detailed information for 250 places will use 250 credits (1 credit per place).
- Example 3: Querying details for 500 places will require 500 credits (1 credit per place).
This credit-based system ensures the Geoapify Place Details API remains flexible and accessible for a variety of project scales, from personal applications to enterprise-level solutions.
FAQ
What kind of data does the Place Details API return?
The Place Details API returns the data depending on the place category and data availability. For example, for a parking place the result may contain "Parking capacity", access information and price, for a heritage place - build year, heritage operator, and level. Check the list of the fields on the documentation page.
Can I use the Place Id from Google Maps API to get information about the place?
Unfortunately no, you can get Place Details for places returned by Geoapify Location Platform APIs - Geocoding API, Places API.
How is the Place Details API billed?
The cost of one Place Details API request depends on the list of requested features. The "default" feature without additionally specified fields costs as 1 "geocoding & places" requests. The "walk_NN" and "drive_NN" features cost additionally 1 isoline request, the "radius_NN.amenity_type", "walk_NN.amenity_type" contain Places API requests and cost more.
Which data sources do you use for the Place Details API?
At the moment we use the OpenStreetMap database and Wikidata as data sources. However, we plan to extend the list. Contact us if your business case is not covered by the API.
Which data format do you use for the Place Details API?
We return data in GeoJSON format as a FeatureCollection, which is natively supported by most client libraries. Here you can find examples of how to visualize the features returned >>
