Mapbox (Independent Publisher) (Preview)
Mapbox allows you to access its navigation, location search and static map generation services to create interative/static maps in your application.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Simone Lin |
| simonelinrj@outlook.com |
| Connector Metadata | |
|---|---|
| Publisher | Simone Lin |
| Website | https://www.mapbox.com/ |
| Privacy policy | https://www.mapbox.com/legal/privacy |
| Categories | Data |
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| API access token | securestring | The app/subscription API access token issued by Mapbox | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Forward Geocoding |
This action allows you to look up a single location by name and will return you the geographic coordinates (latitude and longitude) of the location |
| Get Route To Location |
This action calculates and returns optimal route to reach a specified location from a given location. |
| Get Static Map Image |
This action outputs a static map image of a location in base64, the location is specified by its longitude and latitude. The static map image does not have interactivity or controls. |
Forward Geocoding
This action allows you to look up a single location by name and will return you the geographic coordinates (latitude and longitude) of the location
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Address or post code of the location.
|
search_text | True | string |
An address or a post code of the location that the user wants to retrieve geocoordinates from. |
|
Favor results taht are closer to the specified location
|
proximity | string |
Bias the response to favor results that are closer to this location. Default is ip, or can be longitude,latitude coordinates |
|
|
Feature types included in the search
|
types | string |
Filter results to include only a subset (one or more) of the available feature types. Options are country, region, postcode, district, place, locality, neighborhood, address, and poi |
|
|
Maximum number of results to return
|
limit | integer |
Specify the maximum number of results to return, default is 2 and maximum is 10 |
|
|
Set autocomplete results
|
autocomplete | boolean |
Specify whether to return autocomplete results, default is false. |
|
|
Specify the user's language
|
language | string |
Specify the user's language. This parameter controls the language of the text supplied in responses. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
query
|
query | array of string |
An array of space and punctuation separated strings from the original query |
|
features
|
features | array of object |
An array of feature objects ordered by relevance |
|
feature_relevance
|
features.relevance | float |
Indicates how well the returned feature matches to user's query on a scale of 0 to 1 |
|
feature_placename
|
features.place_name | string |
A string representing the feature in the requested language if specified and its full result hierarchy |
|
bbox
|
features.bbox | array of float |
A bounding box array |
|
center
|
features.center | array of float |
The coordinates of the feature's center in the form of [longitude, latitude], may be the literal center or the center of human activities |
Get Route To Location
This action calculates and returns optimal route to reach a specified location from a given location.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Routing profile
|
routing | True | string |
Routing profile to use possible values are driving-traffic, driving, walking, cycling |
|
Start end coordinate
|
coordinates | True | string |
semicolon-separated list of coordinates. e.g. startlon,startlat;endlon,endlat |
|
Alternative route boolean
|
alternatives | boolean |
If set to true it will return up to two alternative route than the fastest one |
|
|
Returned geometry format
|
geometries | string |
the format of the returned geometry, allowed values are geojson, polyline and polyline6 |
|
|
Type of overview geometry
|
overview | string |
Displays the requested type of overview geometry, can be full (most detailed) simplified or false |
|
|
Set turn by turn instructions
|
steps | boolean |
Whether to return steps and turn-by-turn instructions (true) or not |
|
|
Language of the instructions
|
language | string |
The language of returned turn-by-turn text instructions |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
routes
|
routes | array of object |
describes a route through multiple waypoints |
|
legs
|
routes.legs | array of object |
An array of rout legs |
|
Route summary
|
routes.legs.summary | string |
A summary of the route |
|
Route leg duration
|
routes.legs.duration | float |
The estimated travel time beteen route legs waypoints in seconds |
|
steps
|
routes.legs.steps | array of object |
Depending on the steps parameter this can be either an array of steps or empty array. |
|
driving_side
|
routes.legs.steps.driving_side | string |
The legal driving side at the location for this step. Either left or right. |
|
mode
|
routes.legs.steps.mode | string |
The mode of transportation |
|
bearing_after
|
routes.legs.steps.maneuver.bearing_after | integer |
A number between 0 and 360 indicating the clockwise angle from true north to the direction of travel immediately after the maneuve |
|
maneuver_instruction
|
routes.legs.steps.maneuver.instruction | string |
A human readable instruction of how to execute the returned maneuver |
|
Single maneuver duration
|
routes.legs.steps.duration | integer |
The estimated time traveled, in seconds, from the maneuver to the next route step. |
|
Single maneuver road name
|
routes.legs.steps.name | string |
The name of the road or path that forms part of the route step. |
|
Single maneuver distance
|
routes.legs.steps.distance | integer |
The distance traveled, in meters, from the maneuver to the next route step. |
|
Route leg distance
|
routes.legs.distance | float |
The distance travelled between route leg waypoints in meter |
|
duration
|
routes.duration | float |
The estimated travel time through the waypoints in seconds |
|
distance
|
routes.distance | float |
The distance travelled through the waypoints in meter |
|
waypoints
|
waypoints | array of object |
array of waypoint object |
|
name
|
waypoints.name | string |
the name of the road or path to which the input coordinates have beend snapped |
|
location
|
waypoints.location | array of float |
array of the snapped coordinate in the format [lon, lat] |
Get Static Map Image
This action outputs a static map image of a location in base64, the location is specified by its longitude and latitude. The static map image does not have interactivity or controls.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Pin longitude
|
pinlon | True | string |
longitude value which should be the same as the center longitude specified in variable lon, in order to pin the desired location |
|
Pin latitude
|
pinlat | True | string |
latitude value which should be the same as the center latitude specified in variable lon, in order to pin the desired location |
|
Longitude
|
lon | True | float |
Longitude for the center point of the static map; a number between -180 and 180. |
|
Latitude
|
lat | True | float |
Latitude for the center point of the static map; a number between -85.0511 and 85.0511. |
|
Image Zoom
|
zoom | True | float |
Zoom level; a number between 0 and 22. Fractional zoom levels will be rounded to two decimal places |
|
Image Rotation
|
bearing | True | float |
Bearing rotates the map around its center. A number between 0 and 360, interpreted as decimal degrees. |
|
Image Tilt
|
pitch | True | float |
Pitch tilts the map, producing a perspective effect. A number between 0 and 60, measured in degrees. |
|
Image Width
|
width | True | integer |
Width of the image; a number between 1 and 1280 pixels. |
|
Image Height
|
height | True | integer |
Height of the image; a number between 1 and 1280 pixels. |
Returns
- response
- binary
Definitions
binary
This is the basic data type 'binary'.