The ArcGIS Places service is a location service that can search for businesses and geographic locations around the world. It can find, locate, and discover detailed information about each place. There are many categories to choose from to use as search filters. Icon resources are also provided with results to help style locations.
Service URL
https://places-api.arcgis.com/arcgis/rest/services/places-service/v1
Requests
Name | Description | Price category |
---|---|---|
/places/near-point | Nearby search: Search for places near a location by a radius distance. | |
/places/within-extent | Bounding box search: Search for places within an extent (bounding box). | |
/places/{place | Place details: Get place details including name, location, address, description, and other attributes. Specify the list of fields to return attributes. | |
/categories | Category search: Return the name and category ID of all categories or categories that satisfy a filter. | |
/categories/{category | Category details: Get the category details for a category ID. |
Service data
To view the data providers, coverage, and restrictions, go to Service data.
Pricing
Price category | Fields | ArcGIS Location Platform | ArcGIS Online |
---|---|---|---|
500 free then $8 per 1,000 searches | Not supported | ||
name categories | 100 free then $0.05 per 1,000 places | Not supported | |
location additionalLocations:dropOff additionalLocations:frontDoor additionalLocations:road additionalLocations:roof | 100 free then $0.35 per 1,000 places | Not supported | |
address:adminRegion address:censusBlockId address:country address:designatedMarketArea address:extended address:locality address:neighborhood address:poBox address:postcode address:postTown address:region address:streetAddress | 100 free then $0.1 per 1,000 places | Not supported | |
chains contactInfo:email contactInfo:fax contactInfo:telephone contactInfo:website description hours:opening hours:openingText hours:popular rating:price rating:user socialMedia:facebookId socialMedia:instagram socialMedia:twitter | 100 free then $0.13 per 1,000 places | Not supported | |
$0 | Not supported |
Billing occurs when places or place attributes are returned from a request.
For /places/near-point
or /places/within-extent
, you are charged once per request. You are charged for the initial request and all subsequent paging requests. The maximum number of results returned per request is 20.
For /places/place
, the charges vary based on the attribute data available and the price group the field belongs to (Place attributes, Location attributes, Address attributes, or Details attributes). Each price group contains fields and you are only charged once for the entire set of fields in that group. For example, if you request multiple fields from the same group, you are only charged once. However, if you request two fields from different price groups, you are charged for both groups.
Note: Due to limitations with the underlying data source, the following fields will currently return null
:
Field | Price group |
---|---|
address:censusBlockId | Address |
address:designatedMarketArea | Address |
address:extended | Address |
address:neighborhood | Address |
additionalLocations:* | Location |
chains | Details |
contactInfo:fax | Details |
description | Details |
hours:* | Details |
rating:* | Details |
Terms of use
You cannot permanently store places or place details for future use.
To review the attribution requirements for using ArcGIS services, go to Esri and data attribution.
To review the terms of use that apply to using ArcGIS products, services, and data, go to Esri.com > Esri Legal.