Geo
Bing Geo is LinkedIn location taxonomy. Geo API will provide the display name for a given geo ID, or a set of geo IDs.
Note
All use of the Microsoft Bing Maps location data is subject to Microsoft Bing Maps and MapPoint Web Service End User Terms of Use and Embedded Maps Service Terms of Use and the Microsoft Privacy Statement. By accessing any Microsoft Bing Maps location data, you are agreeing to be bound by these Microsoft terms.
Note
All API requests are represented in protocol 2.0.0 and require the header X-Restli-Protocol-Version: 2.0.0
.
Schema
Field | Description | Format | Required |
---|---|---|---|
defaultLocalizedName | The locale-specific name of the entity. | LocaleString | Optional |
id | Unique identifier for the entity | long | Yes |
Supported Methods
GET
GET https://api.linkedin.com/v2/geo/12345
GET https://api.linkedin.com/v2/geo/12345?locale=(language:en,country:US)
Parameters
Field Name | Sub-Field Name | Description |
---|---|---|
locale | The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not supported. | |
language | A lowercase two-letter language code as defined by ISO-639. | |
country | An uppercase two-letter country code as defined by ISO-3166. |
Sample Response
{
"defaultLocalizedName":{
"locale": {
"country": "US",
"language": "en"
},
"value": "San Francisco Bay Area"
},
"id": 104565322
BATCH GET
GET https://api.linkedin.com/v2/geo?ids=List(12345,23456)
GET https://api.linkedin.com/v2/geo?ids=List(12345,23456)&locale=(language:en,country:US)
Parameters
Field Name | Sub-Field Name | Description |
---|---|---|
locale | The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not supported. | |
language | A lowercase two-letter language code as defined by ISO-639. | |
country | An uppercase two-letter country code as defined by ISO-3166. |
Sample Response
{
"statuses": {},
"results": {
"12345": {
"defaultLocalizedName": {
"locale": {
"country": "US",
"language": "en"
},
"value": "San Francisco Bay Area"
}
},
"23456": {
"defaultLocalizedName": {
"locale": {
"country": "US",
"language": "en"
},
"value": "San Francisco, California, United States"
}
}
},
"errors": {}