Qodex.ai

2. 🏛️ Places service

Number of APIs: 15

🏛️ Places service

Places, also known as points of interest (POIs), are businesses and geographic locations that you can discover around the world. To find places, you use the places service. The service allows you to search for places near a location or within a bounding box. To find specific types of places you can use over 1000 place categories and/or your own text to refine the search results. Places also contain valuable details, also known as attributes, such as name, category, street address, marketing district, contact information, website, social links, hours of operation, price ratings, and user ratings. With the places service you can build powerful applications to help people discover, locate, and learn more about the places around them.

Steps to run a request in the places service collection

❗NOTE: This service only available if you have an ArcGIS Developer account.

  • Fork the Security and authentication and Places service collections. Ensure that you also have the Enhanced endpoints and Global environments. To learn more, go to the workspace [Overview] page.
  • Get an [access token] If you use an API key, ensure that it is scoped to access the places service.
  • Select the operation you want to run.
  • Run the operation.

To learn more, go to How to perform a place search in the Mapping APIs and location services guide.

📄 Guide and API reference

🛠️ Integration

You can access the places service using: ArcGIS REST JS

Places service

The places service is a ready-to-use location service that can search for businesses and geographic locations around the world. It allows you to discover, locate, and find detailed information about each place.

To learn more, go to the service page in the Mapping APIs and location services guide.

Troubleshooting

If you have an issue running the requests, or have any other questions, please go to the Beta program. Or, you can make a comment within a request.

  1. Find place categories - ➡️ categories-spec GET https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/categories

  2. Find place categories - ➡️ categories/{categoryId} GET https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/categories/{placeId}

  3. Nearby search - ➡️ near-point-spec GET https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/near-point

  4. Nearby search-💡 Examples-Page through results - 1. Initial request GET https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/near-point?x=174.778&y=-41.292&pageSize=20&f=pjson&token={{Token}}

  5. Nearby search-💡 Examples-Page through results - 2. Next request GET {{nearbyNextURL}}

  6. Nearby search-💡 Examples - Find places by category and text GET https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/near-point?x=-0.1276&y=51.5073&searchText=sports&radius=1609.344&categoryIds=13018, 13051, 18065&pageSize=20&f=pjson&token={{Token}}

  7. Bounding box search-💡 Examples-Page through results - 1. Initial request GET https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/within-extent?xmin=-122.3216485977173&ymin=47.60912874706993&xmax=-122.34233379364015&ymax=47.602864405717575&pageSize=20&f=pjson&token={{Token}}

  8. Bounding box search-💡 Examples-Page through results - 2. Next request GET {{boundingBoxNextURL}}

  9. Bounding box search-💡 Examples - Find places by category and text GET https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/within-extent?xmin=-0.107&ymin=51.513&xmax=-0.148&ymax=51.502&searchText=sports&categoryids=13018, 13051, 18065&pageSize=20&f=pjson&token={{Token}}

  10. Bounding box search - ➡️ within-extent-spec GET https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/within-extent