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