Mapbox （獨立發行者） （預覽版）
Mapbox 允許您訪問其導航、位置搜索和靜態地圖生成服務，以在您的應用程序中創建交互/靜態地圖。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | 林志穎 |
| simonelinrj@outlook.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 林志穎 |
| 網站 | https://www.mapbox.com/ |
| 隱私策略 | https://www.mapbox.com/legal/privacy |
| 類別 | 資料 |
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 存取權杖 | securestring | Mapbox 發行的應用程式/訂閱 API 存取權杖 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 前向地理編碼 |
此操作允許您按名稱查找單個位置，並返回該位置的地理坐標（緯度和經度） |
| 取得靜態地圖影像 |
此動作會輸出 base64 中某個位置的靜態地圖影像，該位置由其經度和緯度指定。 靜態地圖圖像沒有交互性或控件。 |
| 獲取前往位置的路線 |
此動作會計算並傳回從指定位置到達指定位置的最佳路線。 |
前向地理編碼
此操作允許您按名稱查找單個位置，並返回該位置的地理坐標（緯度和經度）
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
該地點的地址或郵遞區號。
|
search_text | True | string |
使用者想要從中擷取地理座標的位置的地址或郵遞區號。 |
|
偏好更接近指定位置的結果
|
proximity | string |
將回應偏向於更接近此位置的結果。 預設為ip，也可以是經度，緯度座標 |
|
|
搜尋中包含的特徵類型
|
types | string |
篩選結果以僅包含可用特徵類型的子集 （一或多個）。 選項包括國家、地區、郵遞區號、地區、地點、地區、地區、鄰里、地址和 poi |
|
|
要傳回的結果數目上限
|
limit | integer |
指定要傳回的結果數目上限，預設值為 2，最大值為 10 |
|
|
設定自動完成結果
|
autocomplete | boolean |
指定是否傳回自動完成結果，預設值為 false。 |
|
|
指定使用者的語言
|
language | string |
指定使用者的語言。 此參數控制回應中提供的文字語言。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
查詢
|
query | array of string |
空格和標點符號陣列將字串與原始查詢分隔開來 |
|
features
|
features | array of object |
依相關性排序的功能物件陣列 |
|
feature_relevance
|
features.relevance | float |
指出傳回的功能與使用者查詢的比對程度，範圍為 0 到 1 |
|
feature_placename
|
features.place_name | string |
以要求的語言表示功能的字串 （如果指定） 及其完整結果階層 |
|
bbox
|
features.bbox | array of float |
邊界方塊陣列 |
|
中心
|
features.center | array of float |
特徵中心的座標以[經度、緯度]的形式出現，可以是文字中心，也可以是人類活動的中心 |
取得靜態地圖影像
此動作會輸出 base64 中某個位置的靜態地圖影像，該位置由其經度和緯度指定。 靜態地圖圖像沒有交互性或控件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
針腳經度
|
pinlon | True | string |
經度值，該值應與可變 Lon 中指定的中心經度相同，以便釘選所需的位置 |
|
針腳緯度
|
pinlat | True | string |
緯度值，該值應與可變 Lon 中指定的中心緯度相同，以便固定所需的位置 |
|
經度
|
lon | True | float |
靜態地圖中心點的經度;-180 到 180 之間的數字。 |
|
緯度
|
lat | True | float |
靜態地圖中心點的緯度;介於 -85.0511 和 85.0511 之間的數字。 |
|
影像縮放
|
zoom | True | float |
縮放等級;介於 0 到 22 之間的數字。 小數縮放等級將四捨五入到小數點後兩位 |
|
影像旋轉
|
bearing | True | float |
方位角會圍繞其中心旋轉地圖。 介於 0 到 360 之間的數字，解譯為十進制度。 |
|
影像傾斜
|
pitch | True | float |
Pitch 傾斜地圖，產生透視效果。 介於 0 到 60 之間的數字，以度為單位。 |
|
影像寬度
|
width | True | integer |
圖像的寬度;介於 1 到 1280 像素之間的數字。 |
|
影像高度
|
height | True | integer |
圖像的高度;介於 1 到 1280 像素之間的數字。 |
傳回
- response
- binary
獲取前往位置的路線
此動作會計算並傳回從指定位置到達指定位置的最佳路線。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
路由設定檔
|
routing | True | string |
使用可能值的路由設定檔為 driving-traffic、driving、walking、cycling |
|
起點結束座標
|
coordinates | True | string |
以分號分隔的座標清單。 例如startlon，startlat;endlon，endlat |
|
替代路由布林值
|
alternatives | boolean |
如果設定為 true，則會傳回最多兩條比最快路線更替代的路線 |
|
|
傳回的幾何格式
|
geometries | string |
傳回幾何圖形的格式，允許的值為 geojson、polyline 和 polyline6 |
|
|
概觀幾何圖形的類型
|
overview | string |
顯示要求的概觀幾何類型，可以是完整 （最詳細） 簡化或錯誤 |
|
|
設定回合指令
|
steps | boolean |
是否返回步驟和路線說明（true） |
|
|
說明的語言
|
language | string |
傳回的逐步文字指示的語言 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
路線
|
routes | array of object |
描述通過多個航點的路線 |
|
腿
|
routes.legs | array of object |
一系列潰敗腿 |
|
路線摘要
|
routes.legs.summary | string |
路線摘要 |
|
路由段持續時間
|
routes.legs.duration | float |
以秒為單位的路線航點之間的預計旅行時間 |
|
steps
|
routes.legs.steps | array of object |
視步驟參數而定，這可以是步驟陣列或空陣列。 |
|
driving_side
|
routes.legs.steps.driving_side | string |
此步驟位置的合法駕駛方。 要麼左邊，要麼右邊。 |
|
mode
|
routes.legs.steps.mode | string |
交通方式 |
|
bearing_after
|
routes.legs.steps.maneuver.bearing_after | integer |
介於 0 和 360 之間的數字，表示從真北到機動後立即行進方向的順時針角度 |
|
maneuver_instruction
|
routes.legs.steps.maneuver.instruction | string |
人類可讀的指令，說明如何執行傳回的動作 |
|
單次機動持續時間
|
routes.legs.steps.duration | integer |
從機動到下一個路線步驟的估計時間（以秒為單位）。 |
|
單機動道路名稱
|
routes.legs.steps.name | string |
構成路線步驟一部分的道路或路徑的名稱。 |
|
單機動距離
|
routes.legs.steps.distance | integer |
從機動到下一個路線步驟的行駛距離（以米為單位）。 |
|
路線路段距離
|
routes.legs.distance | float |
路線路段航點之間的移動距離（以米為單位） |
|
duration
|
routes.duration | float |
通過航點的預估旅行時間（以秒為單位） |
|
distance
|
routes.distance | float |
通過航路點的距離（以米為單位） |
|
航點
|
waypoints | array of object |
航點物件的陣列 |
|
名稱
|
waypoints.name | string |
輸入座標已鎖點的道路或路徑的名稱 |
|
位置
|
waypoints.location | array of float |
貼齊座標的陣列，格式為 [lon， lat] |
定義
二進位
這是基本數據類型 『binary』。