Base URL Structure

Bing Maps REST URL Structure


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

HTTP protocol

HTTPS protocol

Template Parameters

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.


Required. The REST API that you want to use.

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

Example: Imagery/Map


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


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

A Bing Maps Key obtained from the Bing Maps Account Center

Example: key=A3sbe47EeFWsSlklbe

Although it is described separately in this table because of its importance, the Bing Maps Key is a query parameter.


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



Optional. Specifies whether the response should include error-codes along with the error text, with one of the following values.

  • true

  • false [default]

When this property is provided, response includes an error code along with a description for failed requests:

  • errorCode: "NoSolution"

  • errorDetails: "No route was found for the waypoints provided."


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.
© 2015 Microsoft