Bing Maps (Preview)

Bing Maps

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
Flow Standard All Flow regions
PowerApps Standard All PowerApps regions

Creating a connection

To connect your account, you will need the following information:

Name Type Description
API Key securestring

API Key

Throttling Limits

Name Calls Renewal Period
API calls per connection120060 seconds

Actions

Get location by address

Get the location information associated with an address. If no location is found, an empty result will be returned.

Get location by point

Get the location information associated with latitude and longitude coordinates.

Get route

Calculate a route using waypoints.

Get static map

Get static map.

Get static map [DEPRECATED]

Get static map. This action has been deprecated. Please use GetMapV2 instead.

Get location by address

Get the location information associated with an address. If no location is found, an empty result will be returned.

Parameters

Name Key Required Type Description
Address line
addressLine string

A string specifying the street line of an address (not including city, country region, etc).

Locality (City)
locality string

A string that contains the locality, such as a US city.

Admin district (State)
adminDistrict string

A string that contains a subdivision, such as the abbreviation of a US state.

Postal code
postalCode string

A string that contains the postal code, such as a US ZIP Code.

Country region
countryRegion string

A string specifying the ISO country code.

Returns

Get location by point

Get the location information associated with latitude and longitude coordinates.

Parameters

Name Key Required Type Description
Point Latitude
latitude True double

The latitude coordinate you want to reverse geocode. Example: 47.64054

Point Longitude
longitude True double

The longitude coordinate you want to reverse geocode. Example: -122.12934

Include Entity Types
includeEntityTypes string

The entity types that you want to return in the response.

Include Neighborhood
includeNeighborhood boolean

A value determining whether or not to include the neighborhood in the response when it is available. 0 or 1

Include Country Code
include boolean

A value determining whether or not to include the two-letter ISO country code. ciso2

Returns

Get route

Calculate a route using waypoints.

Parameters

Name Key Required Type Description
Waypoint 1
wp.0 True string

Specified as a point, landmark, or address. (47.610,-122.107 or Seattle, WA)

Waypoint 2
wp.1 True string

Specified as a point, landmark, or address. (47.610,-122.107 or Seattle, WA)

Avoid
avoid string

A comma-separated list of values from the following list (highways, tolls, minimizeHighways, minimizeTolls).

Optimize
optimize string

Specifies what parameters to use to optimize the route.

Distance unit
distanceUnit string

The units to use for distance in the response. Default: Kilometer

Travel mode
travelMode string

The mode of travel for the route. Default: Driving

Transit Date-Time
dateTime string

Required when the travel mode is transit. Identifies the desired transit time, such as arrival time or departure time.

Transit Date-Time Type
timeType string

Required when the travel mode is transit. Specifies how to interpret the transit date-time value.

Returns

Get static map

Get static map.

Parameters

Name Key Required Type Description
Point latitude
latitude True double

The latitude coordinate you want to reverse geocode. Example: 47.64054

Point longitude
longitude True double

The longitude coordinate you want to reverse geocode. Example: -122.12934

Imagery set
imagerySet True string

The type of imagery.

Zoom level
zoomLevel True string

The level of zoom to display between 0 and 21. Default 10

Image format
format string

The image format to use for the static map.

Map size
mapSize string

The width and height in pixels of the static map output. Example: 1000,600.

Pushpin latitude
pushpinLatitude double

Specify pushpin latitude (more information https://aka.ms/u8b8aq).

Pushpin longitude
pushpinLongitude double

Specify pushpin longitude (more information https://aka.ms/u8b8aq).

Pushpin icon style
pushpinIconStyle integer

Specify pushpin icon style (more information https://aka.ms/u8b8aq).

Pushpin label
pushpinLabel string

Specify a label of up to three (3) characters (more information https://aka.ms/u8b8aq).

Returns

response
GetMap_Response

Get static map [DEPRECATED]

Get static map. This action has been deprecated. Please use GetMapV2 instead.

Parameters

Name Key Required Type Description
Point latitude
latitude True string

The latitude coordinate you want to reverse geocode. Example: 47.64054

Point longitude
longitude True string

The longitude coordinate you want to reverse geocode. Example: -122.12934

Imagery set
imagerySet True string

The type of imagery.

Zoom level
zoomLevel True string

The level of zoom to display between 0 and 21. Default 10

Image format
format string

The image format to use for the static map.

Map size
mapSize string

The width and height in pixels of the static map output. Example: 1000,600.

Pushpin
pushpin string

Point value (latitude and longitude) with options to add a label of up to three (3) characters and to specify an icon style. Example: 47.610,-122.107;5;P10 (more information https://aka.ms/u8b8aq).

Returns

response
GetMap_Response

Definitions

GetRoute_Response

Name Path Type Description
Distance Unit
distanceUnit string

The unit used for distance.

Duration Unit
durationUnit string

The unit used for time of travel.

Latitude
routeLegs.actualEnd.coordinates.latitude float

The latitude point that was used as the actual ending location for the route leg.

Longitude
routeLegs.actualEnd.coordinates.longitude float

The longitude point that was used as the actual ending location for the route leg.

Combined
routeLegs.actualEnd.coordinates.combined string

Comma separated latitude and longitude values.

Type
routeLegs.actualEnd.type string
Latitude
routeLegs.actualStart.coordinates.latitude float

The latitude that was used as the actual starting location for the route leg.

Longitude
routeLegs.actualStart.coordinates.longitude float

The longitude that was used as the actual starting location for the route leg.

Combined
routeLegs.actualStart.coordinates.combined string

Comma separated latitude and longitude values.

Type
routeLegs.actualStart.type string
Description
routeLegs.description string

A short description of the route.

Country Region
routeLegs.endLocation.address.countryRegion string

Country or region name of an address.

Formatted Address
routeLegs.endLocation.address.formattedAddress string

A string specifying the complete address.

Confidence
routeLegs.endLocation.confidence string

The confidence of the match.

Entity Type
routeLegs.endLocation.entityType string

A type of location. Examples include PopulatedPlace and Monument.

Name
routeLegs.endLocation.name string
Region
routeLegs.routeRegion string

routeRegion

Country Region
routeLegs.startLocation.address.countryRegion string

Country or region name of an address.

Formatted Address
routeLegs.startLocation.address.formattedAddress string

A string specifying the complete address.

Confidence
routeLegs.startLocation.confidence string

The confidence of the match.

Entity Type
routeLegs.startLocation.entityType string

A type of location. Examples include PopulatedPlace and Monument.

Name
routeLegs.startLocation.name string

name

Traffic Congestion
trafficCongestion string
Traffic Data Used
trafficDataUsed string
Travel Distance
travelDistance float

The physical distance covered by the entire route.

Travel Duration
travelDuration integer

The time that it takes, in seconds, to travel a corresponding travel distance.

Travel Duration Traffic
travelDurationTraffic integer

The time that it takes, in seconds, to travel a corresponding TravelDistance with current traffic conditions.

GetLocation_Response

Name Path Type Description
Line
address.addressLine string

The official street line of an address.

Country Region
address.countryRegion string

Country or region name of an address.

Country Region ISO 2
address.countryRegionIso2 string

The two-letter ISO country code.

Formatted Address
address.formattedAddress string

A string specifying the complete address.

Postal Code
address.postalCode string

The post code, postal code, or ZIP Code of an address.

Confidence
confidence string

The confidence of the match.

Entity Type
entityType string

A type of location. Examples include PopulatedPlace and Monument.

Name
name string
Latitude
point.coordinates.latitude float

The latitude point that was used for the location.

Longitude
point.coordinates.longitude float

The longitude point that was used for the location.

Combined
point.coordinates.combined string

Comma separated latitude and longitude values.

Type
point.type string

type

GetMap_Response

Map Image
binary