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 | BATCH_GET

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": {}