How to perform a place search

The general steps to find places with the places service are to:

1. Select a category

To start searching for places, you should identify one or more place categories for the types of places you are interested in. Categories are used to help filter search results so only the type of places you are interested in are returned. All categories have a name and a unique ID. To help find the appropriate category (and ID), you can use the /categories request or the places category finder tool.

Use dark colors for code blocksCopy
1
https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/categories?filter=grocery&token=<ACCESS_TOKEN>&f=pjson
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
  "categories": [
    {
      "categoryId": "17069",
      "fullLabel": [
        "Retail",
        "Food and Beverage Retail",
        "Grocery Store / Supermarket"
      ],
      "parents": [
        "17000",
        "17057"
      ]
    },
Expand

2. Search for places

To search for places you can use the /places/near-point or /places/within-extent request. To filter and return the best results, you should provide a list of categories and/or keywords when you search. When places are returned, they contain attributes such as name, placeId, location, and categories. You can use the place attributes to display them on a map or to get more details about each place.

Nearby search

Use dark colors for code blocksCopy
1
https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/near-point?x=-3.1883&y=55.9533&radius=500&categoryIds=17069&pageSize=1&token=<ACCESS_TOKEN>&f=pjson

Bounding box search

Use dark colors for code blocksCopy
1
https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/within-extent?xmin=-3.1951975822448735&ymin=55.95079788951077&xmax=-3.180649280548096&ymax=55.95603574810763&categoryIds=17069&pageSize=1&token=<ACCESS_TOKEN>&f=pjson
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "results": [
    {
      "placeId": "5bbf7493cc5ed5a7f0b8ac78220aa301",
      "location": {
        "x": -3.191426,
        "y": 55.952693
      },
      "categories": [
        {
          "categoryId": "17069",
          "label": "Grocery Store / Supermarket"
        },
        {
          "categoryId": "17071",
          "label": "Health Food Store"
        }
      ],
      "name": "The Refillery",
      "distance": 206.0
    }
}

3. Get place information

After you perform a place search, you can use /places/{placeId} to request additional attributes for each place. To do so, you use a place ID and set the requestedFields parameter to specify the fields you want. The request fields are grouped into Place, Address, and/or Details price groups. The number of attributes returned can vary depending on the type of place.

Use dark colors for code blocksCopy
1
https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/5bbf7493cc5ed5a7f0b8ac78220aa301?requestedFields=all&token=<ACCESS_TOKEN>&f=pjson
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
{
  "placeDetails": {
    "placeId": "5bbf7493cc5ed5a7f0b8ac78220aa301",
    "categories": [
      {
        "categoryId": "17069",
        "label": "Grocery Store / Supermarket"
      },
      {
        "categoryId": "17071",
        "label": "Health Food Store"
      }
    ],
    "name": "The Refillery",
    "description": null,
    "address": {
      "streetAddress": null,
      "extended": null,
      "locality": "Edinburgh",
      "designatedMarketArea": null,
      "region": "Lothian",
      "postcode": "EH1 1BQ",
      "poBox": null,
      "country": "GB",
      "adminRegion": "Scotland",
      "postTown": "Edinburgh",
      "neighborhood": [

      ],
      "censusBlockId": null
    },
Expand

Tutorials

Services

Places service

Find and get details about businesses, places, and other POI.

API support

Category searchNearby searchBounding box searchPlace details
ArcGIS Maps SDK for JavaScript1
ArcGIS Maps SDK for .NET
ArcGIS Maps SDK for Kotlin
ArcGIS Maps SDK for Swift
ArcGIS Maps SDK for Java
ArcGIS Maps SDK for Qt
ArcGIS API for Python
ArcGIS REST JS
Esri Leaflet2222
MapLibre GL JS2222
OpenLayers2222
CesiumJS2222
Full supportPartial supportNo support
  • 1. Access via ArcGIS REST JS
  • 2. Access via ArcGIS REST JS.

Tools

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.