Location and Recognition Entity Types
The response returned by the Location Recognition API contains one or more entity types. This article provides descriptions of the various fields associated with each entity type.
Businesses at Location
Entities like local businesses, offices, museums, parks, and points of interest are grouped under the businessesAtLocation
element in the response. Each businessesAtLocation
element contains the following fields.
Field Name | Description |
---|---|
BusinessLocationEntity |
Container element (XML only) for the businessAddress and businessInfo fields. |
businessesAddress |
Address of the business entity. Multiple entities can be situated at the input location, in such cases each entity has its own address. |
businessInfo |
Name, type and other information about the business entity. |
Example
The following example shows a businessesAtLocation
element in the Location Recognition API response.
"businessesAtLocation": [
{
"businessAddress": {
"latitude": 47.6427448210338,
"longitude": -122.12949670889715,
"addressLine": "1 Microsoft Way",
"locality": "Redmond",
"adminDivision": "WA",
"countryIso2": "US",
"postalCode": "98052",
"formattedAddress": "1 Microsoft Way, Redmond, WA 98052, US"
},
"businessInfo": {
"id": "873x2278110160718493824",
"entityName": "Microsoft",
"url": "https://www.microsoft.com/en-us/",
"phone": "(425) 882-8080",
"typeId": 91600,
"otherTypeIds": [
91046,
90100
],
"type": "IndustrialStructure",
"otherTypes": [
"Information Technology Companies",
"B2B Business Services",
"Business-to-Business"
]
}
}
Business Address
A businessAddress
element contains the following fields.
Field Name | Description |
---|---|
latitude,longitude |
Latitude and longitude of the business or location. Note that business locations are approximate and aren't guaranteed to be accurate. |
Note
For the other fields in business address refer to Location and Area Types.
Business Information
A businessInfo
element contains the following fields.
Field Name | Description |
---|---|
entityName |
Name of the business entity. |
url |
Website URL of the business entity. |
phone |
Phone number of the business entity. |
type |
Type of business entity representing the primary nature of business of the entity. Refer to the Business Entity Types list for a full list of supported types. |
otherTypes |
List of types that represent the secondary nature of business of the entity. |
Business Entity Types
The list of supported entity types.
- Arts & entertainment
- Automotive
- Banking & finance
- Beauty & spa
- Business-to-business
- Education
- Food & drink
- Government
- Healthcare
- News & media
- Professional services
- Real estate
- Religion
- Retail
- Sports & recreation
- Travel
Note
Granular categories are available under these top-level categories (e.g. different cuisines are available under ‘restaurants’ which itself is under ‘Food & drink’).
Natural Points of Interest at Location
Natural entities like beaches, etc., are placed in the naturalPOIAtLocation
element. Each natural entity has the following fields.
Field Name | Description |
---|---|
entityName |
Name of the natural entity or point of interest. |
latitude,longitude |
Location coordinates of the entity. |
type |
Type of natural entity. See the following list of supported types. |
The complete list of supported natural entity types.
- Bay
- Beach
- Canal
- Forest
- Island
- Lake
- Mountain
- Plateau
- Reserve
- River
- Sea
- Valley