User Context Parameters

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.

Use user context parameters to specify information about the user. You can increase the accuracy of a location result when you specify a user context parameter in your request URL.

When an alias is provided, you can use the alias to shorten the length of the query parameter.

Parameter Alias Description Values
userMapView umv Optional. The geographic region that corresponds to the current viewport. A rectangular area on the earth defined as a bounding box object. The sides of the rectangles are defined by latitude and longitude values. For more information, see Location and Area Types. When you specify this parameter, the geographical area is taken into account when computing the results of a location query.

Example: 40.879052728414536,-122.51596324145794,49.77062925696373,-105.74403114616871
userLocation ul Optional. The user’s current position. A point on the earth specified as a latitude and longitude. When you specify this parameter, the user’s location is taken into account and the results returned may be more relevant to the user.

Example: userLocation=51.504360719046616,-0.12600176611298197
userIp uip Optional. An Internet Protocol version 4 (IPv4) address. The default address is the IPv4 address of the request. When you specify this parameter, the location associated with the IP address is taken into account in computing the results of a location query.

Example: userIp=111.111.11.11
userRegion ur Optional. The region the user is in. A string that an ISO 3166-1 Alpha-2 region/country code. This will alter Geopolitical disputed borders and labels to align with the specified user region.

Example: userRegion=SA