Types

AdditionalLocations

Example
Use dark colors for code blocksCopy
{
  "dropOff": {
    "x": -117.194769,
    "y": 34.057289
  },
  "frontDoor": {
    "x": -117.194769,
    "y": 34.057289
  },
  "road": {
    "x": -117.194769,
    "y": 34.057289
  },
  "roof": {
    "x": -117.194769,
    "y": 34.057289
  }
}

A set of additional locations for the place, as WGS84 points.

This list provides alternative locations for accessing a place such as frontDoor or road.

Properties

Name	Type	Description
`dropOff`	`NullablePoint`	A location for drop-off/pick-up for a place.
`frontDoor`	`NullablePoint`	A location for the front door for a place.
`road`	`NullablePoint`	A road-side location for a place.
`roof`	`NullablePoint`	A location in the roof centroid for a place.

Address

Example
Use dark colors for code blocksCopy
{
  "streetAddress": "380 New York St",
  "extended": "Unit 32",
  "locality": "Redlands",
  "designatedMarketArea": "Los Angeles",
  "region": "CA",
  "postcode": "92373",
  "poBox": "string",
  "country": "US",
  "adminRegion": "Scotland",
  "postTown": "Edinburgh",
  "neighborhood": [
    "Downtown"
  ],
  "censusBlockId": "060710081003002"
}

The address of a place, or point of interest (POI).

Properties

Name	Type	Description
`streetAddress`	`string¦null`	The street address for a place, for example the street name and number.
`extended`	`string¦null`	Additional address information, including suite or apartment numbers.
`locality`	`string¦null`	The city, town, or equivalent.
`designatedMarketArea`	`string¦null`	As defined by Nielsen, signifies a region where the population can receive similar TV and radio offerings (US only).
`region`	`string¦null`	The state, province, territory or equivalent.
`postcode`	`string¦null`	Postal code or equivalent (zip code in the US). Format will be localized based on country.
`poBox`	`string¦null`	Post-office box.
`country`	`string¦null`	Two letter ISO country code
`adminRegion`	`string¦null`	Additional sub-division. Usually, but not always, a country sub-division (e.g., Scotland).
`postTown`	`string¦null`	Town/place employed in postal addressing.
`neighborhood`	`[string]`	The neighborhoods of the place.
`censusBlockId`	`string¦null`	The census block Id of the place (US only).

Name	Type	Required	Description
`categoryId`	`CategoryId`		The category Id uniquely identifies this category or type of place. The name of the category can be looked up using the `places/categories` endpoint. For example, "4bf58dd8d48988d115951735" is the id for a "Bicycle Store".
`label`	`string`		The label that describes the category.

CategoryDetails

Example
Use dark colors for code blocksCopy
{
  "categoryId": "4bf58dd8d48988d115951735",
  "fullLabel": [
    [
      "Retail",
      "Sporting Goods Retail",
      "Bicycle Store"
    ]
  ],
  "parents": [
    [
      "4bf58dd8d48988d1f2941735"
    ]
  ],
  "icon": {
    "url": "https://static.arcgis.com/icons/places/Default_Shop_or_Service_15.svg"
  }
}

Provides details about a category or type of place.

Categories are hierarchical so that you can filter places based on specific categories such as "Provençal Restaurant", or with more generic types such as "Restaurant". A category such as "Provençal Restaurant" includes the details of its more generic parent, such as "French Restaurant".

Properties

Name	Type	Description
`categoryId`	`CategoryId`	A unique identifying string for a category. This matches the `categoryId` of a place's `category` property.
`fullLabel`	`[string]`	The full list of labels that describe the category, including its more generic parent categories.
`parents`	`[string]`	The list of parent category Ids for this category.
`icon`	`IconDetails`	Details of an icon, suitable for depicting this place. To fetch icon details use the `icon` query parameter.

CategoryId

Example
Use dark colors for code blocksCopy
"4bf58dd8d48988d115951735"

Type: string
Required: false
Restrictions: none
Minimum length: 24
Maximum length: 24

ChainInfo

Example
Use dark colors for code blocksCopy
{
  "name": "Starbucks"
}

Information about a chain that a place belongs to.

Properties

Name	Type	Required	Description
`name`	`string¦null`		The name of the chain.

ContactInfo

Example
Use dark colors for code blocksCopy
{
  "telephone": "(909) 793-2853",
  "website": "https://www.esri.com",
  "fax": "0800 169 2008",
  "email": "support@esri.com"
}

The contact information for a place.

Properties

Name	Type	Description
`telephone`	`string¦null`	The telephone number of the place.
`website`	`string(url)¦null`	The website address of the place.
`fax`	`string¦null`	Fax number.
`email`	`string¦null`	Email address.

Error

Example
Use dark colors for code blocksCopy
{
  "error": {
    "code": 400,
    "message": "Parameter invalid.",
    "details": [
      "string"
    ],
    "restInfoUrl": "https://places-api.arcgis.com/arcgis/rest/info"
  }
}

Properties

Name	Type	Required	Description
`error`	`object`		Error information

`error` properties

Name	Type	Description
`code`	`integer`	A code identifying the type of error. This can be an HTTP status code, `498` (invalid or expired token), or `499` (missing token).
`message`	`string`	A message describing the error.
`details`	`[string]`	List of details about the error.
`restInfoUrl`	`string(url)`	A link to general information about the service, such as the owning system and token service URL. This property is only present for errors relating to tokens.

Enumerated values

code

400

Click to copy

401

Click to copy

403

Click to copy

404

Click to copy

498

Click to copy

499

Click to copy

500

Click to copy

Hours

Example
Use dark colors for code blocksCopy
{
  "opening": {
    "monday": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "tuesday": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "wednesday": [
      {
        "from": "09:00",
        "to": "12:00"
      },
      {
        "from": "13:00",
        "to": "17:00"
      }
    ],
    "thursday": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "friday": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "saturday": [
      {
        "from": "10:00",
        "to": "17:00"
      }
    ],
    "sunday": [
      {
        "from": "11:00",
        "to": "12:00"
      }
    ]
  },
  "popular": {
    "monday": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "tuesday": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "wednesday": [
      {
        "from": "09:00",
        "to": "12:00"
      },
      {
        "from": "13:00",
        "to": "17:00"
      }
    ],
    "thursday": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "friday": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "saturday": [
      {
        "from": "10:00",
        "to": "17:00"
      }
    ],
    "sunday": [
      {
        "from": "11:00",
        "to": "12:00"
      }
    ]
  },
  "openingText": "Mon-Thu 12:00 PM-11:00 PM; Fri-Sat 12:00 PM-11:30 PM; Sun 12:00 PM-10:30 PM"
}

Lists the opening hours of this place or POI along with the popular or busy hours.

A string is also provided that can be used for display.

Properties

Name Type Required Description

Name	Type	Description
`opening`	`HoursByDay`	The opening hours for a place. Opening hours are shown by day of the week. Each day can have several pairs of from and to times. For example, if a coffee shop is open from 9:00 until 12:00 and then again from 13:00 until 17:00, it would contain two pairs of from/to times: 09:00 paired with 12:00 and 13:00 with 17:00. Opening hours are shown in 24-hour time in the local timezone of the place or POI.
`popular`	`HoursByDay`	The popular or busy hours for a place. Popular hours are shown by day of the week. Each day can have several pairs of from and to times. For example, if a coffee shop is popular from 9:00 until 10:00 and then again from 14:00 until 15:00, it would contain two pairs of from/to times: 09:00 paired with 10:00 and 14:00 with 15:00. Popular hours are shown in 24-hour time in the local timezone of the place or POI.
`openingText`	`string¦null`	The opening hours for this place, formatted for display.

opening

HoursByDay

The opening hours for a place.

Opening hours are shown by day of the week. Each day can have several pairs of from and to times. For example, if a coffee shop is open from 9:00 until 12:00 and then again from 13:00 until 17:00, it would contain two pairs of from/to times: 09:00 paired with 12:00 and 13:00 with 17:00. Opening hours are shown in 24-hour time in the local timezone of the place or POI.

popular

HoursByDay

The popular or busy hours for a place.

Popular hours are shown by day of the week. Each day can have several pairs of from and to times. For example, if a coffee shop is popular from 9:00 until 10:00 and then again from 14:00 until 15:00, it would contain two pairs of from/to times: 09:00 paired with 10:00 and 14:00 with 15:00. Popular hours are shown in 24-hour time in the local timezone of the place or POI.

openingText

string¦null

The opening hours for this place, formatted for display.

HoursByDay

Example
Use dark colors for code blocksCopy
{
  "monday": [
    {
      "from": "09:00",
      "to": "17:00"
    }
  ],
  "tuesday": [
    {
      "from": "09:00",
      "to": "17:00"
    }
  ],
  "wednesday": [
    {
      "from": "09:00",
      "to": "12:00"
    },
    {
      "from": "13:00",
      "to": "17:00"
    }
  ],
  "thursday": [
    {
      "from": "09:00",
      "to": "17:00"
    }
  ],
  "friday": [
    {
      "from": "09:00",
      "to": "17:00"
    }
  ],
  "saturday": [
    {
      "from": "10:00",
      "to": "17:00"
    }
  ],
  "sunday": [
    {
      "from": "11:00",
      "to": "12:00"
    }
  ]
}

The opening or popular hours for a place.

Opening hours are shown by day of the week. Each day can have several pairs of from and to times. For example, if a coffee shop is open from 9:00 until 12:00 and then again from 13:00 until 17:00, it would contain two pairs of opening/closing times: 9:00 paired with 12:00 and 13:00 with 17:00. Hours are shown in 24-hour time in the local timezone of the place or POI.

Properties

Name	Type	Required
`monday`	`[TimeRange]`
`tuesday`	`[TimeRange]`
`wednesday`	`[TimeRange]`
`thursday`	`[TimeRange]`
`friday`	`[TimeRange]`
`saturday`	`[TimeRange]`
`sunday`	`[TimeRange]`

IconDetails

Example
Use dark colors for code blocksCopy
{
  "url": "https://static.arcgis.com/icons/places/Default_Shop_or_Service_15.svg"
}

Information about an icon for depicting a place or category.

Properties

Name	Type	Required	Description
`url`	`string(url)`		Url for an icon for this place or category in either `svg`, `cim` or `png` format.

NearPointResult

Example
Use dark colors for code blocksCopy
{
  "placeId": "2da082218b6f7538e52250999c8f8ef1",
  "location": {
    "x": -117.194769,
    "y": 34.057289
  },
  "categories": [
    {
      "categoryId": "63be6904847c3692a84b9b90",
      "label": "Technology Business"
    }
  ],
  "name": "Esri International",
  "distance": 50,
  "icon": {
    "url": "https://static.arcgis.com/icons/places/Default_Shop_or_Service_15.svg"
  }
}

A result of searching for places using a places/near-point request.

The result object includes a single place that satisfied the search and the distance from the search point, in meters.

Properties

Name	Type	Description
`placeId`	`PlaceId`	The unique Id of this place. This place Id can be passed to the `places/{placeId}` endpoint to retrieve additional details.
`location`	`Point`	The location of this place as a WGS84 point.
`categories`	`[Category]`	A list of category objects for a place. Categories are uniquely identified by a `categoryId`. For example, `4bf58dd8d48988d115951735` identifies a "Bicycle Store" and `4bf58dd8d48988d184941735` identifies a "Stadium". Note that a single place can belong to multiple categories (for example, a petrol station could also have a super-market).
`name`	`string`	The name of the place, or point of interest. You can search for places by name using the `searchText` property in a `places/near-point` or `places/within-extent` request.
`distance`	`number`	The distance, in meters, from the place to the search point of a 'places/near-point` query.
`icon`	`IconDetails`	Details of an icon, suitable for depicting this place. To fetch icon details use the `icon` query parameter.

NullablePoint

Example
Use dark colors for code blocksCopy
{
  "x": -117.194769,
  "y": 34.057289
}

A point defined in WGS84 decimal degrees.

Properties

Name	Type	Required	Description
`x`	`XCoord`		The x, or longitude, of this location in WGS84 decimal degrees.
`y`	`YCoord`		The y, or latitude, of this location in WGS84 decimal degrees.

Pagination

Example
Use dark colors for code blocksCopy
{
  "previousUrl": "https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/near-point?x=-117.194769&y=34.057289&radius=50.0&offset=0&pageSize=10",
  "nextUrl": "https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/places/near-point?x=-117.194769&y=34.057289&radius=50.0&offset=20&pageSize=10"
}

Provides pagination links for accessing more results for the current request.

Properties

Name Type Required Description

Name	Type	Required	Description
`previousUrl`	`string(url)`		A url for fetching the previous page of results. Use this property to request the previous page of results if available. If this property is omitted then there are no previous pages of results. You must also supply authentication details, such as a `token`, to make a previous page request.
`nextUrl`	`string(url)`		A url for fetching the next page of results. Use this property to request the next page of results if available. If this property is omitted then there are no more pages of results available. You must also supply authentication details, such as a `token`, to make a next page request.

previousUrl

string(url)

A url for fetching the previous page of results.

Use this property to request the previous page of results if available. If this property is omitted then there are no previous pages of results. You must also supply authentication details, such as a token, to make a previous page request.

nextUrl

string(url)

A url for fetching the next page of results.

Use this property to request the next page of results if available. If this property is omitted then there are no more pages of results available. You must also supply authentication details, such as a token, to make a next page request.

PlaceDetails

Example
Use dark colors for code blocksCopy
{
  "placeId": "2da082218b6f7538e52250999c8f8ef1",
  "categories": [
    {
      "categoryId": "63be6904847c3692a84b9b90",
      "label": "Technology Business"
    }
  ],
  "name": "Esri International",
  "location": {
    "x": -117.194769,
    "y": 34.057289
  },
  "description": "Esri is the global market leader in geographic information system\n(GIS) technology, location intelligence, mapping software, and\nspatial analytics. Esri software is deployed in more than 350,000\norganizations and 75 percent of Fortune 500 companies.\n",
  "address": {
    "streetAddress": "380 New York St",
    "extended": "Unit 32",
    "locality": "Redlands",
    "designatedMarketArea": "Los Angeles",
    "region": "CA",
    "postcode": "92373",
    "poBox": "string",
    "country": "US",
    "adminRegion": "Scotland",
    "postTown": "Edinburgh",
    "neighborhood": [
      "Downtown"
    ],
    "censusBlockId": "060710081003002"
  },
  "additionalLocations": {
    "dropOff": {
      "x": -117.194769,
      "y": 34.057289
    },
    "frontDoor": {
      "x": -117.194769,
      "y": 34.057289
    },
    "road": {
      "x": -117.194769,
      "y": 34.057289
    },
    "roof": {
      "x": -117.194769,
      "y": 34.057289
    }
  },
  "contactInfo": {
    "telephone": "(909) 793-2853",
    "website": "https://www.esri.com",
    "fax": "0800 169 2008",
    "email": "support@esri.com"
  },
  "socialMedia": {
    "facebookId": 183768242996,
    "twitter": "esri",
    "instagram": "esrigram"
  },
  "hours": {
    "opening": {
      "monday": [
        {
          "from": "09:00",
          "to": "17:00"
        }
      ],
      "tuesday": [
        {
          "from": "09:00",
          "to": "17:00"
        }
      ],
      "wednesday": [
        {
          "from": "09:00",
          "to": "12:00"
        },
        {
          "from": "13:00",
          "to": "17:00"
        }
      ],
      "thursday": [
        {
          "from": "09:00",
          "to": "17:00"
        }
      ],
      "friday": [
        {
          "from": "09:00",
          "to": "17:00"
        }
      ],
      "saturday": [
        {
          "from": "10:00",
          "to": "17:00"
        }
      ],
      "sunday": [
        {
          "from": "11:00",
          "to": "12:00"
        }
      ]
    },
    "popular": {
      "monday": [
        {
          "from": "09:00",
          "to": "17:00"
        }
      ],
      "tuesday": [
        {
          "from": "09:00",
          "to": "17:00"
        }
      ],
      "wednesday": [
        {
          "from": "09:00",
          "to": "12:00"
        },
        {
          "from": "13:00",
          "to": "17:00"
        }
      ],
      "thursday": [
        {
          "from": "09:00",
          "to": "17:00"
        }
      ],
      "friday": [
        {
          "from": "09:00",
          "to": "17:00"
        }
      ],
      "saturday": [
        {
          "from": "10:00",
          "to": "17:00"
        }
      ],
      "sunday": [
        {
          "from": "11:00",
          "to": "12:00"
        }
      ]
    },
    "openingText": "Mon-Thu 12:00 PM-11:00 PM; Fri-Sat 12:00 PM-11:30 PM; Sun 12:00 PM-10:30 PM"
  },
  "rating": {
    "price": "cheap",
    "user": 4.5
  },
  "chains": [
    {
      "name": "Starbucks"
    }
  ],
  "icon": {
    "url": "https://static.arcgis.com/icons/places/Default_Shop_or_Service_15.svg"
  }
}

The additional details for a Place, including address, contact details, opening hours, and rating.

You can request additional details for a place by using the placeId in a places/{placeId} request. Use the requestedFields query parameter to choose the fields or attributes that are included in the response.

Properties

Name	Type	Description
`placeId`	`PlaceId`	The unique Id of this place.
`categories`	`[Category]`	A list of category objects for a place. Categories are uniquely identified by a `categoryId`. For example, `4bf58dd8d48988d115951735` identifies a "Bicycle Store" and `4bf58dd8d48988d184941735` identifies a "Stadium". Note that a single place can belong to multiple categories (for example, a petrol station could also have a super-market). This property is part of the "Place" attribute group.
`name`	`string`	The name of the place, or point of interest. This property is part of the "Place" attribute group.
`location`	`Point`	The location of this place as a WGS84 point. This property is part of the "Location" attribute group.
`description`	`string¦null`	A text description of the place. This property is part of the "Details" attribute group.
`address`	`Address`	The address of the place or point of interest (POI). This object and child properties are part of the "Address" attribute group.
`additionalLocations`	`AdditionalLocations`	A set of additional locations that represent the place as WGS84 points, for example the location of the front door, or of a drop off point. This object and child properties are part of the "Location" attribute group.
`contactInfo`	`ContactInfo`	Contact information for the place, such as the telephone number or email address. This object and child properties are part of the "Details" attribute group.
`socialMedia`	`SocialMedia`	Social media information associated with the place. This object and child properties are part of the "Details" attribute group.
`hours`	`Hours`	The operating hours for the place, including hours of opening and popular times. This object and child properties are part of the "Details" attribute group.
`rating`	`Rating`	Rating information supplied by users of the place. This object and child properties are part of the "Details" attribute group.
`chains`	`[ChainInfo]`	Information about all the chains the place belongs to. This object and child properties are part of the "Details" attribute group.
`icon`	`IconDetails`	Details of an icon, suitable for depicting this place. To fetch icon details use the `icon` query parameter.

PlaceId

Example
Use dark colors for code blocksCopy
"2da082218b6f7538e52250999c8f8ef1"

An ID that uniquely identifies a place.

A place ID is a 32 character string.

Type: string
Required: false
Restrictions: none
Minimum length: 32
Maximum length: 32

Point

Example
Use dark colors for code blocksCopy
{
  "x": -117.194769,
  "y": 34.057289
}

A point defined in WGS84 decimal degrees.

Properties

Name	Type	Required	Description
`x`	`XCoord`		The x, or longitude, of this location in WGS84 decimal degrees.
`y`	`YCoord`		The y, or latitude, of this location in WGS84 decimal degrees.

Rating

Example
Use dark colors for code blocksCopy
{
  "price": "cheap",
  "user": 4.5
}

Rating information about the price and user rating of the place.

Properties

Name	Type	Required	Description
`price`	`string¦null`		An indication of the overall price of a place based on user reviews.
`user`	`number(float)¦null`		A rating for the place based on user-reviews from 0 to 5, where 5 is the best rating.

Enumerated values

price

cheap

Click to copy

moderate

Click to copy

expensive

Click to copy

veryExpensive

Click to copy

SearchDistance

Example
Use dark colors for code blocksCopy
50

A search distance in meters.

Type: number(float)
Required: false
Restrictions: none
Default value: 1000
Minimum: 1
Maximum: 10000

SocialMedia

Example
Use dark colors for code blocksCopy
{
  "facebookId": 183768242996,
  "twitter": "esri",
  "instagram": "esrigram"
}

The social media details for a place.

Properties

Name	Type	Description
`facebookId`	`string¦null`	The facebook Id of the place.
`twitter`	`string¦null`	The twitter handle of the place.
`instagram`	`string¦null`	The instagram ID of the place.

TimeRange

Example
Use dark colors for code blocksCopy
{
  "from": "10:00",
  "to": "13:00"
}

A pair of times defining the start and end of a time period.

For example, this could define opening hours or popular hours. Hours are shown in 24-hour time in the local timezone of the place or POI.

Where a time range is 24-hours (for example a venue that is open 24-hours), the from property will be 00:00 and the to property will be 23:59.

Properties

Name	Type	Required	Description
`from`	`string`		The start of a time range in the format "HH:MM".
`to`	`string`		The end of a time range in the format "HH:MM".

WithinExtentResult

Example
Use dark colors for code blocksCopy
{
  "placeId": "2da082218b6f7538e52250999c8f8ef1",
  "location": {
    "x": -117.194769,
    "y": 34.057289
  },
  "categories": [
    {
      "categoryId": "63be6904847c3692a84b9b90",
      "label": "Technology Business"
    }
  ],
  "name": "Esri International",
  "icon": {
    "url": "https://static.arcgis.com/icons/places/Default_Shop_or_Service_15.svg"
  }
}

A result of searching for places using a places/within-extent request.

The result object includes a single place that satisfied the search.

Properties

Name	Type	Description
`placeId`	`PlaceId`	The unique Id of this place. This place Id can be passed to the `places/{placeId}` endpoint to retrieve additional details.
`location`	`Point`	The location of this place as a WGS84 point.
`categories`	`[Category]`	A list of category objects for a place. Categories are uniquely identified by a `categoryId`. For example, `4bf58dd8d48988d115951735` identifies a "Bicycle Store" and `4bf58dd8d48988d184941735` identifies a "Stadium". Note that a single place can belong to multiple categories (for example, a petrol station could also have a super-market).
`name`	`string`	The name of the place, or point of interest. You can search for places by name using the `searchText` property in a `places/near-point` or `places/within-extent` request.
`icon`	`IconDetails`	Details of an icon, suitable for depicting this place. To fetch icon details use the `icon` query parameter.

XCoord

Example
Use dark colors for code blocksCopy
-117.194769

An x-coordinate, or longitude, in WGS84 decimal degrees.

Type: number(double)
Required: false
Restrictions: none
Minimum: -180
Maximum: 180

YCoord

Example
Use dark colors for code blocksCopy
34.057289

A y-coordinate, or latitude, in WGS84 decimal degrees.

Type: number(double)
Required: false
Restrictions: none
Minimum: -90
Maximum: 90

Types

AdditionalLocations

Properties

Address

Properties

Category

Properties

CategoryDetails

Properties

CategoryId

ChainInfo

Properties

ContactInfo

Properties

Error

Properties

error properties

Enumerated values

code

Hours

Properties

HoursByDay

Properties

IconDetails

Properties

NearPointResult

Properties

NullablePoint

Properties

Pagination

Properties

PlaceDetails

Properties

PlaceId

Point

Properties

Rating

Properties

Enumerated values

price

SearchDistance

SocialMedia

Properties

TimeRange

Properties

WithinExtentResult

Properties

XCoord

YCoord

`error` properties