Export (0) Print
Expand All

Bing Maps REST URL Structure

Bing

The Bing Maps REST Services are all called by using the following base formats.

HTTP protocol

http://dev.virtualearth.net/REST/version/restApi/resourcePath?queryParameters&key=BingMapsKey

HTTPS protocol

https://dev.virtualearth.net/REST/version/restApi/resourcePath?queryParameters&key=BingMapsKey

Template Parameters

Ff701720.note(en-us,MSDN.10).gifNote:
All parameters in the Bing Maps REST Services are not case-sensitive.

URL parameter Description Values

version (v+ API version number)

Required. The version of the Bing Maps REST Services that you want to use.

A string containing v and an integer that specifies the version of the Bing Maps REST Services.

Example: v1.

restApi

Required. The REST API that you want to use.

A part of the URL path that identifies the REST API.

Example: Imagery/Map

resourcePath

Optional. Additional parameters that define a resource

A part of the URL path that specifies a resource, such as an address or landmark.

Example: BirdsEye/51.5063249319792,-0.127144753932953

key

Required. The Bing Maps Key to use for the request.

A Bing Maps Key obtained from the Bing Maps Account Center

Example: key=A3sbe47EeFWsSlklbe

Ff701720.note(en-us,MSDN.10).gifNote:
Although it is described separately in this table because of its importance, the Bing Maps Key is a query parameter.

queryParameters

Optional with exceptions. One or more parameters and values that define the request.

Depending on the request, query parameters may be optional or required. Query parameters consist of global parameters and parameters that are specific to each REST API. The Bing Maps Key is a required query parameter.

Example: userLocation=49.1231,-98.231

Example

The following example request specifies to use version one (v1) of the Bing Maps REST Services to find location information for the city of Seattle. The information will be returned in an XML format.

http://dev.virtualearth.net/REST/v1/Locations?q=seattle&output=xml&key=BingMapsKey
Show:
© 2014 Microsoft