Geospatial Endpoint Service

Note

Bing Maps for Enterprise service retirement

Bing Maps for Enterprise is deprecated and will be retired. Free (Basic) account customers can continue to use Bing Maps for Enterprise services until June 30th, 2025. Enterprise account customers can continue to use Bing Maps for Enterprise services until June 30th, 2028. To avoid service disruptions, all implementations using Bing Maps for Enterprise REST APIs and SDKs will need to be updated to use Azure Maps by the retirement date that applies to your Bing Maps for Enterprise account type.

Azure Maps is Microsoft's next-generation maps and geospatial services for developers. Azure Maps has many of the same features as Bing Maps for Enterprise, and more. To get started with Azure Maps, create a free Azure subscription and an Azure Maps account. For more information about azure Maps, see Azure Maps Documentation. For migration guidance, see Bing Maps Migration Overview.

The Geospatial Endpoint Service is a REST service that provides information about Geospatial Platform services for the language and geographical region you specify. The service information includes available service endpoints and language support for these endpoints. Disputed geographical areas and embargoed countries or regions that do not have any service support are also identified.

This documentation does not explain how to use the service endpoints returned in the response.

Request URLs

Use the following URLs to make a Geospatial Endpoint Service request. Options are provided for requests with and without specific geographical coordinates.

Get the service information for the language and region specified.

http://dev.virtualearth.net/REST/V1/GeospatialEndpoint/language/userRegion?key={BingMapsKey}  

Get the service information for the language, region and location coordinates specified.

The latitude and longitude coordinates are reverse-geocoded to determine the location. If this location corresponds to a non-disputed country or region, then this location overrides the userRegion value in the request. However, if the coordinates are in a disputed country or region, then the userRegion in the request is used. For example, if the coordinates represent a disputed area along the border of India and China, and userRegion is set to IN (India) in the request and the language is set to hi-in (Hindi), then IN services for Hindi are returned. In the same example, if the userRegion is set to CN (China) and the language is set to zh-hans (Simplified Chinese), then CN services for Simplified Chinese are returned in the response.

http://dev.virtualearth.net/REST/V1/GeospatialEndpoint/language/userRegion/latitude,longitude?key={BingMapsKey}  

Parameters

Parameter Alias Description Values
language The preferred language. An IETF language code, that includes the language and region code subtags, such as en-us or zh-hans.

Example: en-us

This code represents English as it is spoken in the United States.

Example: zh-hans

This code represents Simplified Chinese.
userRegion A country or region. An ISO 3166-1 alpha-2 region code, such as US, IN, and CN.

Example: US

This code represents the United States.
latitude, longitude A location on the Earth.

These coordinates are reverse-geocoded to determine the country or region. If this location is in a disputed area, then the userRegion parameter value is used to determine the corresponding region.
The latitude and longitude of the user’s location in degrees.

Example: 33.977531,75.726013
output o Optional. The output format for the response. One of the following values:

- json [default]
- xml

Example: o=xml
key Your Bing Maps Key. The GUID value that represents a Bing Maps Key.

Response

The response returns the following information:

  • Whether this is a politically disputed area, such as an area claimed by more than one country/region.

  • Whether services are available in the user’s region.

  • A list of available geospatial services including endpoints and language support for each service.

Using the Endpoints with Parameters

It is important to note that the endpoints returned in the response are not typically URLs that you can execute. They give the base URL to which you can add parameters, such as a quad key for an image, route waypoints or an address to geocode. This documentation does not cover the parameters specific to each service.

For example, a common endpoint for geocoding is dev.virtualearth.net\REST\v1\Locations. However, this URL does not return any results without adding parameters. The following example shows how to geocode an address by providing address information and a Bing Maps Key.

http://dev.virtualearth.net/REST/v1/Locations?q=1%20Microsoft%20Way%20Redmond%20WA%2098052&o=xml&key=YourBingMapsKey  

Response Fields

The following example shows the general structure for the JSON response. You can also request an XML response. Example requests and JSON and XML responses are provided in the Examples section.

{  
   "authenticationResultCode":"ValidCredentials",  
   "brandLogoUri":"https:\/\/2.gy-118.workers.dev/:443\/http\/dev.virtualearth.net\/Branding\/logo_powered_by.png",  
   "copyright":"Copyright © 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",  
   "resourceSets":[  
      {  
         "estimatedTotal":1,  
         "resources":[  
            {  
               "__type":"GeospatialEndpoint:https:\/\/2.gy-118.workers.dev/:443\/http\/schemas.microsoft.com\/search\/local\/ws\/rest\/v1",  
               "isDisputedArea":false,  
               "isSupported":true,  
               "ur":"FR",  
               "services":[  
                  {  
                     "endpoint":"ecn.dynamic.t{0-3}.tiles.virtualearth.net\/comp\/ch\/{quadkey}?mkt={market}&it=G,VE,BX,L,LA&shading=hill&n=z&ur={userregion}",  
                     "fallbackLanguage":null,  
                     "languageSupported":true,  
                     "serviceName":"MapTiles"  
                  },  
                  {  
                     "endpoint":"dev.virtualearth.net\/REST\/v1\/Locations",  
                     "fallbackLanguage":null,  
                     "languageSupported":true,  
                     "serviceName":"Geocode"  
                  },  
                  {  
                     "endpoint":"dev.virtualearth.net\/REST\/v1\/Routes",  
                     "fallbackLanguage":null,  
                     "languageSupported":true,  
                     "serviceName":"Route"  
                  }  
               ]  
            }  
         ]  
      }  
   ],  
   "statusCode":200,  
   "statusDescription":null,  
   "traceId":"961e9c1e63e64bd4aa7d140ee4e05697"  
}  

General Fields

JSON XML Type Description
isDisputedArea IsDisputedArea Boolean Specifies if this area in the request is claimed by more than one country/region. For example, many areas along the border of India and China are disputed areas. Even though an area is disputed area, it may still be supported by Geospatial Platform services.
isSupported IsSupported Boolean Specifies if Geospatial Platform services are available in the country or region. Microsoft does not support services in embargoed areas. For example, if you request Geospatial Platform Service information for Cuba (CU), isSupported is set to true, and no service information is returned.
ur (user region) UR (user region) string The country or region that was used to determine service support. If you specified a latitude and longitude in the request that is in a non-disputed country or region, this country or region is returned in the response.

Please see the section Region Localities below for more details on the User Region Codes and Culture Codes.
services Services array Information for each geospatial service that is available in the country or region and language specified in the request.

See the Service Fields table for the information provided for each service.

For a list of available services, see Supported Services.

Region Localities

In order to get this label to appear, the user region of the map has to be set to one of following User Region Codes.

User Region Code Official Short Form Culture Code
IL Israel He-il
KR Korea Ko-kr
PK Pakistan pa-pk
IN India En-in
CN China zh-cn
AR Argentina es-AR
BH Bahrain ar-BH
EG Egypt ar-EG
JO Jordon ar-JO
SA Saudi Arabia ar-SA
KW Kuwait ar-KW
OM Oman ar-OM
QA Qatar ar-QA
MA Morocco ar-MA
AE UAE ar-AE

Service Fields

JSON XML Type Description
endpoint Endpoint URL The URL service endpoint to use in this region. Note that to use the service, you must typically add parameters specific to the service. These parameters are not described in this documentation.
languageSupported LanguageSupported Boolean Set to true if the service supports the language in the request for the region. If the language is supported, then the service endpoint will return responses using this language. If it is not supported, then the service will use the fallback language.
fallbackLanguage FallbackLanguage string Specifies the secondary or fallback language in this region or country. If the requested language is not supported and a fallback language is not available, United States English (en-us) is used.
serviceName ServiceName string An abbreviated name for the service. See Supported Services for a list of available services.

Response Container Fields

JSON XML Type Description
statusCode StatusCode integer The HTTP Status code for the request.
statusDescription StatusDescription string A description of the HTTP status code.
authenticationResultCode AuthenticationResultCode One of the following values:

ValidCredentials

InvalidCredentials

CredentialsExpired

NotAuthorized

NoCredentials

None
A status code that offers additional information about authentication success or failure.
traceId TraceId string A unique identifier for the request.
copyright Copyright string A copyright notice.
brandLogoUri BrandLogoUri string A URL that references a brand image to support contractual branding requirements.
resourceSets ResourceSets collection A collection of ResourceSet objects. A ResourceSet is a container of Resources returned by the request. For more information, see the ResourceSet section below.
estimatedTotal EstimatedTotal long An estimate of the total number of resources in the ResourceSet.
resources Resources collection A collection of one or more resources. The resources that are returned depend on the request. Information about resources is provided in the API reference for each Bing Maps REST Services API.
errorDetails ErrorDetails string[] A collection of error descriptions. For example, ErrorDetails can identify parameter values that are not valid or missing.

Supported Services

The following table describes the services that are supported by the Geospatial Endpoint Service. Information about one or more of these services may be returned in the response.

Service Type Response Service Name Description
Map Imagery MapTiles Returns tiles from one of the following map tile services depending on the user region and language specified in the request.

- On Demand Tile Service: Returns map tiles that are created on the server. This service endpoint will be provided when the user is in a geopolitically sensitive area, such as a disputed area or a country associated with such an area.
- Pre-rendered Tile Service: Returns map tiles that have been pre-rendered during offline processing. This service endpoint will be provided when the user is not in a geopolitically sensitive area.
Map Imagery TrafficTiles Returns map tiles that show traffic flow overlays.
Map Imagery StaticMapsB2B Static Map API (Bing Maps REST Services): Returns static maps for the parameters that you specify. For parameter descriptions, see the documentation.

Note: You must replace the dev.virtualearth.net endpoint in the documentation with the endpoint provided in the response.
Map Metadata MetadataB2B Map Imagery Metadata API (Bing Maps REST Services): Returns map metadata for the parameters that you specify. For parameter descriptions, see the documentation.

Note: You must use the endpoint provided in the response to replace the public dev.virtualearth.net endpoint in the documentation.
Geocode Geocode Locations API (Bing Maps REST Services): Returns geocoded or reverse-geocoded location information for the parameters you specify. For parameter descriptions, see the documentation.

Note: You must replace the dev.virtualearth.net endpoint in the documentation with the endpoint provided in the response.
Route Route Routes API (Bing Maps REST Services): Returns route information for the parameters you specify. For parameter descriptions, see the documentation.

Note: You must use the endpoint provided in the response to replace the public dev.virtualearth.net endpoint in the documentation.
Image URL BingLogo Returns the attribution logo to display with Bing Maps tiles that do not include Nokia data.
Image URL CombinedLogo Returns the attribution logo to display with Bing Maps tiles that include Nokia data.

Examples

Typical Service support example

Language: fr-fr (French), userRegion: FR (France)

http://dev.virtualearth.net/REST/V1/GeospatialEndpoint/fr-fr/FR?key={BingMapsKey}  
{  
   "authenticationResultCode":"ValidCredentials",  
   "brandLogoUri":"https:\/\/2.gy-118.workers.dev/:443\/http\/dev.virtualearth.net\/Branding\/logo_powered_by.png",  
   "copyright":"Copyright © 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",  
   "resourceSets":[  
      {  
         "estimatedTotal":1,  
         "resources":[  
            {  
               "__type":"GeospatialEndpointResponse:https:\/\/2.gy-118.workers.dev/:443\/http\/schemas.microsoft.com\/search\/local\/ws\/rest\/v1",  
               "isDisputedArea":false,  
               "isSupported":true,  
               "services":[  
                  {  
                     "endpoint":"ecn.dynamic.t{0-3}.tiles.virtualearth.net\/comp\/ch\/{quadkey}?mkt={market}&it=G,VE,BX,L,LA&shading=hill&n=z&ur={userregion}",  
                     "fallbackLanguage":"fr",  
                     "languageSupported":false,  
                     "serviceName":"MapTiles"  
                  },  
                  {  
                     "endpoint":"ecn.t{0-7}.tiles.virtualearth.net\/tiles\/dp\/content?mkt={market}&p=tf&a={quadkey}&n=z",  
                     "fallbackLanguage":"fr",  
                     "languageSupported":false,  
                     "serviceName":"TrafficTiles"  
                  },  
                  {  
                     "endpoint":"dev.virtualearth.net\/REST\/V1\/Imagery\/Map",  
                     "fallbackLanguage":"fr",  
                     "languageSupported":false,  
                     "serviceName":"StaticMapsB2B"  
                  },  
                  {  
                     "endpoint":"dev.virtualearth.net\/REST\/V1\/Imagery\/Metadata",  
                     "fallbackLanguage":"fr",  
                     "languageSupported":false,  
                     "serviceName":"MetadataB2B"  
                  },  
                  {  
                     "endpoint":"dev.virtualearth.net\/REST\/v1\/Locations",  
                     "fallbackLanguage":"fr",  
                     "languageSupported":false,  
                     "serviceName":"Geocode"  
                  },  
                  {  
                     "endpoint":"dev.virtualearth.net\/REST\/v1\/Routes",  
                     "fallbackLanguage":"fr",  
                     "languageSupported":false,  
                     "serviceName":"Route"  
                  },  
                  {  
                     "endpoint":"ecn.dev.virtualearth.net\/Branding\/logo_powered_by.png",  
                     "fallbackLanguage":"fr",  
                     "languageSupported":false,  
                     "serviceName":"BingLogo"  
                  },  
                  {  
                     "endpoint":"ecn.dev.virtualearth.net\/Branding\/logo_powered_by.png",  
                     "fallbackLanguage":"fr",  
                     "languageSupported":false,  
                     "serviceName":"CombinedLogo"  
                  }  
               ],  
               "ur":"FR"  
            }  
         ]  
      }  
   ],  
   "statusCode":200,  
   "statusDescription":"OK",  
   "traceId":"4bcd1b7077e84c049cfbbcda3632c22a"  
}  

You would receive the following JSON response if the output=xml parameter was set in this example.

<?xml version="1.0" encoding="utf-8"?>  
<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/search/local/ws/rest/v1">  
  <Copyright>Copyright © 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.</Copyright>  
  <BrandLogoUri>http://dev.virtualearth.net/Branding/logo_powered_by.png</BrandLogoUri>  
  <StatusCode>200</StatusCode>  
  <StatusDescription>OK</StatusDescription>  
  <AuthenticationResultCode>ValidCredentials</AuthenticationResultCode>  
  <TraceId>00e37177aa52425083eae9fc4874fceb</TraceId>  
  <ResourceSets>  
    <ResourceSet>  
      <EstimatedTotal>1</EstimatedTotal>  
      <Resources>  
        <Resource xsi:type="GeospatialEndpointResponse">  
          <UR>FR</UR>  
          <IsDisputedArea>false</IsDisputedArea>  
          <IsSupported>true</IsSupported>  
          <Services>  
            <ServiceInfo>  
              <ServiceName>MapTiles</ServiceName>  
              <Endpoint>ecn.dynamic.t{0-3}.tiles.virtualearth.net/comp/ch/{quadkey}?mkt={market}&amp;it=G,VE,BX,L,LA&amp;shading=hill&amp;n=z&amp;ur={userregion}</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>fr</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>TrafficTiles</ServiceName>  
              <Endpoint>ecn.t{0-7}.tiles.virtualearth.net/tiles/dp/content?mkt={market}&amp;p=tf&amp;a={quadkey}&amp;n=z</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>fr</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>StaticMapsB2B</ServiceName>  
              <Endpoint>dev.virtualearth.net/REST/V1/Imagery/Map</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>fr</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>MetadataB2B</ServiceName>  
              <Endpoint>dev.virtualearth.net/REST/V1/Imagery/Metadata</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>fr</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>Geocode</ServiceName>  
              <Endpoint>dev.virtualearth.net/REST/v1/Locations</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>fr</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>Route</ServiceName>  
              <Endpoint>dev.virtualearth.net/REST/v1/Routes</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>fr</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>BingLogo</ServiceName>  
              <Endpoint>ecn.dev.virtualearth.net/Branding/logo_powered_by.png</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>fr</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>CombinedLogo</ServiceName>  
              <Endpoint>ecn.dev.virtualearth.net/Branding/logo_powered_by.png</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>fr</FallbackLanguageId>  
            </ServiceInfo>  
          </Services>  
        </Resource>  
      </Resources>  
    </ResourceSet>  
  </ResourceSets>  
</Response>  

No Service support example

Language: en-us (English), userRegion: CU (Cuba)

http://dev.virtualearth.net/REST/V1/GeospatialEndpoint/en-us/cu?key={BingMapsKey}  
{  
   "authenticationResultCode":"ValidCredentials",  
   "brandLogoUri":"https:\/\/2.gy-118.workers.dev/:443\/http\/dev.virtualearth.net\/Branding\/logo_powered_by.png",  
   "copyright":"Copyright © 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",  
   "resourceSets":[  
      {  
         "estimatedTotal":1,  
         "resources":[  
            {  
               "__type":"GeospatialEndpointResponse:https:\/\/2.gy-118.workers.dev/:443\/http\/schemas.microsoft.com\/search\/local\/ws\/rest\/v1",  
               "isDisputedArea":false,  
               "isSupported":false,  
               "services":null,  
               "ur":"CU"  
            }  
         ]  
      }  
   ],  
   "statusCode":200,  
   "statusDescription":"OK",  
   "traceId":"eaaa2cd43ebb48a597baa601eb2437df  
}  

You would receive the following JSON response if the output=xml parameter was set in this example. Note that the Services array does not appear.

<?xml version="1.0" encoding="utf-8"?>  
<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/search/local/ws/rest/v1">  
  <Copyright>Copyright © 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.</Copyright>  
  <BrandLogoUri>http://dev.virtualearth.net/Branding/logo_powered_by.png</BrandLogoUri>  
  <StatusCode>200</StatusCode>  
  <StatusDescription>OK</StatusDescription>  
  <AuthenticationResultCode>ValidCredentials</AuthenticationResultCode>  
  <TraceId>2559b704c7e34392b95bfb99437060adTraceId>  
  <ResourceSets>  
    <ResourceSet>  
      <EstimatedTotal>1</EstimatedTotal>  
      <Resources>  
        <Resource xsi:type="GeospatialEndpointResponse">  
          <UR>CU</UR>  
          <IsDisputedArea>false</IsDisputedArea>  
          <IsSupported>false</IsSupported>  
        </Resource>  
      </Resources>  
    </ResourceSet>  
  </ResourceSets>  
</Response>  

Disputed area example

Language: zh-hans (Simplified Chinese), userRegion: CN (China), Coordinates: Disputed Area between India and China

Note

The response shows CN as the region because the latitude and longitude are in a disputed area.

http://dev.virtualearth.net/REST/V1/GeospatialEndpoint/zh-hans/cn/32.750323,79.376221?key={BingMapsKey}  
{  
   "authenticationResultCode":"ValidCredentials",  
   "brandLogoUri":"https:\/\/2.gy-118.workers.dev/:443\/http\/dev.virtualearth.net\/Branding\/logo_powered_by.png",  
   "copyright":"Copyright © 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",  
   "resourceSets":[  
      {  
         "estimatedTotal":1,  
         "resources":[  
            {  
               "__type":"GeospatialEndpointResponse:https:\/\/2.gy-118.workers.dev/:443\/http\/schemas.microsoft.com\/search\/local\/ws\/rest\/v1",  
               "isDisputedArea":true,  
               "isSupported":true,  
               "services":[  
                  {  
                     "endpoint":"r{0-3}.tiles.ditu.live.com\/tiles\/r{quadkey}.png?g={generation}",  
                     "fallbackLanguage":null,  
                     "languageSupported":true,  
                     "serviceName":"RoadWithLabels"  
                  },  
                  {  
                     "endpoint":"r{0-3}.tiles.ditu.live.com\/tiles\/r{quadkey}.png?g={generation}",  
                     "fallbackLanguage":null,  
                     "languageSupported":true,  
                     "serviceName":"MapTiles"  
                  },  
                  {  
                     "endpoint":"traftile.mapabc.com\/trafficengine\/traffictile?Key={quadkey}",  
                     "fallbackLanguage":null,  
                     "languageSupported":true,  
                     "serviceName":"TrafficTiles"  
                  },  
                  {  
                     "endpoint":"dev.ditu.live.com\/REST\/V1\/Imagery\/Map",  
                     "fallbackLanguage":null,  
                     "languageSupported":true,  
                     "serviceName":"StaticMapsB2B"  
                  },  
                  {  
                     "endpoint":"dev.ditu.live.com\/REST\/V1\/Locations",  
                     "fallbackLanguage":null,  
                     "languageSupported":true,  
                     "serviceName":"Geocode"  
                  },  
                  {  
                     "endpoint":"dev.ditu.live.com\/REST\/V1\/Routes",  
                     "fallbackLanguage":null,  
                     "languageSupported":true,  
                     "serviceName":"Route"  
                  }  
               ],  
               "ur":"CN"  
            }  
         ]  
      }  
   ],  
   "statusCode":200,  
   "statusDescription":"OK",  
   "traceId":"711c2b03cb1744f2849eddfd7a7650a3"  
}  

You would receive the following JSON response if the output=xml parameter was set in this example.

<?xml version="1.0" encoding="utf-8"?>  
<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/search/local/ws/rest/v1">  
  <Copyright>Copyright © 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.</Copyright>  
  <BrandLogoUri>http://dev.virtualearth.net/Branding/logo_powered_by.png</BrandLogoUri>  
  <StatusCode>200</StatusCode>  
  <StatusDescription>OK</StatusDescription>  
  <AuthenticationResultCode>ValidCredentials</AuthenticationResultCode>  
  <TraceId>94994c4c84da4c40a32e55c0c2a76b06</TraceId>  
  <ResourceSets>  
    <ResourceSet>  
      <EstimatedTotal>1</EstimatedTotal>  
      <Resources>  
        <Resource xsi:type="GeospatialEndpointResponse">  
          <UR>CN</UR>  
          <IsDisputedArea>true</IsDisputedArea>  
          <IsSupported>true</IsSupported>  
          <Services>  
            <ServiceInfo>  
              <ServiceName>RoadWithLabels</ServiceName>  
              <Endpoint>r{0-3}.tiles.ditu.live.com/tiles/r{quadkey}.png?g={generation}</Endpoint>  
              <LanguageSupported>true</LanguageSupported>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>MapTiles</ServiceName>  
              <Endpoint>r{0-3}.tiles.ditu.live.com/tiles/r{quadkey}.png?g={generation}</Endpoint>  
              <LanguageSupported>true</LanguageSupported>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>TrafficTiles</ServiceName>  
              <Endpoint>traftile.mapabc.com/trafficengine/traffictile?Key={quadkey}</Endpoint>  
              <LanguageSupported>true</LanguageSupported>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>StaticMapsB2B</ServiceName>  
              <Endpoint>dev.ditu.live.com/REST/V1/Imagery/Map</Endpoint>  
              <LanguageSupported>true</LanguageSupported>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>Geocode</ServiceName>  
              <Endpoint>dev.ditu.live.com/REST/V1/Locations</Endpoint>  
              <LanguageSupported>true</LanguageSupported>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>Route</ServiceName>  
              <Endpoint>dev.ditu.live.com/REST/V1/Routes</Endpoint>  
              <LanguageSupported>true</LanguageSupported>  
            </ServiceInfo>  
          </Services>  
        </Resource>  
      </Resources>  
    </ResourceSet>  
  </ResourceSets>  
</Response>  

Language: hi-in (Hindi), userRegion: IN (India), Coordinates: Disputed Area between India and China

Note

The response shows IN as the region because the latitude and longitude coordinates are in a disputed area.

http://dev.virtualearth.net/REST/V1/GeospatialEndpoint/hi-in/in/32.750323,79.376221?key={BingMapsKey}  
{  
   "authenticationResultCode":"ValidCredentials",  
   "brandLogoUri":"https:\/\/2.gy-118.workers.dev/:443\/http\/dev.virtualearth.net\/Branding\/logo_powered_by.png",  
   "copyright":"Copyright © 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",  
   "resourceSets":[  
      {  
         "estimatedTotal":1,  
         "resources":[  
            {  
               "__type":"GeospatialEndpointResponse:https:\/\/2.gy-118.workers.dev/:443\/http\/schemas.microsoft.com\/search\/local\/ws\/rest\/v1",  
               "isDisputedArea":true,  
               "isSupported":true,  
               "services":[  
                  {  
                     "endpoint":"ecn.dynamic.t{0-3}.tiles.virtualearth.net\/comp\/ch\/{quadkey}?mkt=en-us&it=G,L&shading=hil&n=z",  
                     "fallbackLanguage":"en-US",  
                     "languageSupported":false,  
                     "serviceName":"RoadWithLabels"  
                  },  
                  {  
                     "endpoint":"ecn.dynamic.t{0-3}.tiles.virtualearth.net\/comp\/ch\/{quadkey}?mkt=en-us&it=A,G,L&n=z",  
                     "fallbackLanguage":"en-US",  
                     "languageSupported":false,  
                     "serviceName":"AerialWithLabels"  
                  },  
                  {  
                     "endpoint":"ecn.dynamic.t{0-3}.tiles.virtualearth.net\/comp\/ch\/{quadkey}?mkt=en-us&it=G&shading=hill&n=z",  
                     "fallbackLanguage":"en-US",  
                     "languageSupported":false,  
                     "serviceName":"RoadWithoutLabels"  
                  },  
                  {  
                     "endpoint":"ecn.dynamic.t{0-3}.tiles.virtualearth.net\/comp\/ch\/{quadkey}?mkt=en-us&it=A,G&n=z",  
                     "fallbackLanguage":"en-US",  
                     "languageSupported":false,  
                     "serviceName":"AerialWithoutLabels"  
                  },  
                  {  
                     "endpoint":"ecn.dynamic.t{0-3}.tiles.virtualearth.net\/comp\/ch\/{quadkey}?mkt={market}&it=G,VE,BX,L,LA&shading=hill&n=z&ur={userregion}",  
                     "fallbackLanguage":"en-US",  
                     "languageSupported":false,  
                     "serviceName":"MapTiles"  
                  },  
                  {  
                     "endpoint":"ecn.t{0-7}.tiles.virtualearth.net\/tiles\/dp\/content?mkt={market}&p=tf&a={quadkey}&n=z",  
                     "fallbackLanguage":"en-US",  
                     "languageSupported":false,  
                     "serviceName":"TrafficTiles"  
                  },  
                  {  
                     "endpoint":"dev.virtualearth.net\/REST\/V1\/Imagery\/Map",  
                     "fallbackLanguage":"en-US",  
                     "languageSupported":false,  
                     "serviceName":"StaticMapsB2B"  
                  },  
                  {  
                     "endpoint":"dev.virtualearth.net\/REST\/V1\/Imagery\/Metadata",  
                     "fallbackLanguage":"en-US",  
                     "languageSupported":false,  
                     "serviceName":"MetadataB2B"  
                  },  
                  {  
                     "endpoint":"dev.virtualearth.net\/REST\/v1\/Locations",  
                     "fallbackLanguage":"en-US",  
                     "languageSupported":false,  
                     "serviceName":"Geocode"  
                  },  
                  {  
                     "endpoint":"dev.virtualearth.net\/REST\/v1\/Routes",  
                     "fallbackLanguage":"en-US",  
                     "languageSupported":false,  
                     "serviceName":"Route"  
                  }  
               ],  
               "ur":"IN"  
            }  
         ]  
      }  
   ],  
   "statusCode":200,  
   "statusDescription":"OK",  
   "traceId":"c3d472f7ba6b4c8bbcb4a41c1ce82e8b  
}  

You would receive the following JSON response if the output=xml parameter was set in this example.

<?xml version="1.0" encoding="utf-8"?>  
<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/search/local/ws/rest/v1">  
  <Copyright>Copyright © 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.</Copyright>  
  <BrandLogoUri>http://dev.virtualearth.net/Branding/logo_powered_by.png</BrandLogoUri>  
  <StatusCode>200</StatusCode>  
  <StatusDescription>OK</StatusDescription>  
  <AuthenticationResultCode>ValidCredentials</AuthenticationResultCode>  
  <TraceId>105c3b6e5e6a4577a4bb405b72a2b413|CPKM001262|02.00.117.100|</TraceId>  
  <ResourceSets>  
    <ResourceSet>  
      <EstimatedTotal>1</EstimatedTotal>  
      <Resources>  
        <Resource xsi:type="GeospatialEndpointResponse">  
          <UR>IN</UR>  
          <IsDisputedArea>true</IsDisputedArea>  
          <IsSupported>true</IsSupported>  
          <Services>  
            <ServiceInfo>  
              <ServiceName>RoadWithLabels</ServiceName>  
              <Endpoint>ecn.dynamic.t{0-3}.tiles.virtualearth.net/comp/ch/{quadkey}?mkt=en-us&amp;it=G,L&amp;shading=hil&amp;n=z</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>en-US</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>AerialWithLabels</ServiceName>  
              <Endpoint>ecn.dynamic.t{0-3}.tiles.virtualearth.net/comp/ch/{quadkey}?mkt=en-us&amp;it=A,G,L&amp;n=z</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>en-US</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>RoadWithoutLabels</ServiceName>  
              <Endpoint>ecn.dynamic.t{0-3}.tiles.virtualearth.net/comp/ch/{quadkey}?mkt=en-us&amp;it=G&amp;shading=hill&amp;n=z</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>en-US</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>AerialWithoutLabels</ServiceName>  
              <Endpoint>ecn.dynamic.t{0-3}.tiles.virtualearth.net/comp/ch/{quadkey}?mkt=en-us&amp;it=A,G&amp;n=z</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>en-US</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>MapTiles</ServiceName>  
              <Endpoint>ecn.dynamic.t{0-3}.tiles.virtualearth.net/comp/ch/{quadkey}?mkt={market}&amp;it=G,VE,BX,L,LA&amp;shading=hill&amp;n=z&amp;ur={userregion}</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>en-US</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>TrafficTiles</ServiceName>  
              <Endpoint>ecn.t{0-7}.tiles.virtualearth.net/tiles/dp/content?mkt={market}&amp;p=tf&amp;a={quadkey}&amp;n=z</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>en-US</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>StaticMapsB2B</ServiceName>  
              <Endpoint>dev.virtualearth.net/REST/V1/Imagery/Map</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>en-US</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>MetadataB2B</ServiceName>  
              <Endpoint>dev.virtualearth.net/REST/V1/Imagery/Metadata</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>en-US</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>Geocode</ServiceName>  
              <Endpoint>dev.virtualearth.net/REST/v1/Locations</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>en-US</FallbackLanguageId>  
            </ServiceInfo>  
            <ServiceInfo>  
              <ServiceName>Route</ServiceName>  
              <Endpoint>dev.virtualearth.net/REST/v1/Routes</Endpoint>  
              <LanguageSupported>false</LanguageSupported>  
              <FallbackLanguageId>en-US</FallbackLanguageId>  
            </ServiceInfo>  
          </Services>  
        </Resource>  
      </Resources>  
    </ResourceSet>  
  </ResourceSets>  
</Response>