必要條件 - Amazon Location Service
建立路線計算器資源驗證您的請求

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

必要條件

在開始計算路線之前，請遵循先決條件步驟：

建立路線計算器資源

在您可以計算路線之前，請先在AWS帳戶中建立路線計算機資源。

建立路線計算器資源時，您可以從可用的資料提供者中進行選擇：

  1. Esri — 有關 Esri 在您感興趣的地區覆蓋的更多信息，請參閱 Esri 有關街道網絡和流量覆蓋範圍的詳細信息。

  2. HERE 技術 — 有關您感興趣地區 HERE 覆蓋範圍的更多信息，請參閱 HERE 汽車路線覆蓋範圍和 HERE 卡車路線覆蓋範圍。

  3. 抓取 — 如需 Grab 涵蓋範圍的詳細資訊，請參閱所涵蓋的國家 ／ 地區。

注意

如果您的應用程式正在對業務中使用的資產 (例如送貨車輛或員工) 進行追蹤或路線規劃，則不得使用 Esri 作為地理位置提供者。如需詳細資訊，請參閱 AWS 服務條款第 82 條。

您可以使用 Amazon 定 Location Service 主控台AWS CLI、或 Amazon 位置 API 來執行此操作。

Console

使用 Amazon 位置主控台建立路線計算器資源

  1. 在 https://console.aws.amazon.com/location/ 打開 Amazon 位置控制台。

  2. 在左側導覽窗格中，選擇「路線計算器」。

  3. 選擇建立路線計算器。

  4. 填寫下列方塊：

    • 名稱 — 輸入路線計算器資源的名稱。例如，ExampleCalculator. 最多可輸入 100 個字元 有效的項目包括英數字元、連字號、句號和底線。

    • 說明 — 輸入選擇性說明。

  5. 對於資料提供者，請選擇要用作路線計算器的資料提供者。

  6. (選用) 在 Tags (標籤) 底下，輸入標籤 Key (金鑰) 與 Value (值)。這將為您的新路線計算器資源添加一個標籤。如需詳細資訊，請參閱標記您的資源。

  7. 選擇建立路線計算器。

API

使用 Amazon 位置 API 創建路線計算器資源

使用來自 Amazon 位置位置 API 的CreateRouteCalculator操作。

下列範例是建立ExampleCalculator使用資料提供者 Esri 呼叫的路由計算器資源的 API 要求。

POST /routes/v0/calculators
Content-type: application/json

{
   "CalculatorName": "ExampleCalculator",
   "DataSource": "Esri",
   "Description": "string",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}
AWS CLI

使用指令建立路線計算器資源的AWS CLI步驟

使用 create-route-calculator 命令。

下列範例會建立ExampleCalculator使用 Esri 做為資料提供者呼叫的路由計算器資源。

aws location \
  create-route-calculator \
  --calculator-name "ExampleCalculator" \
  --data-source "Esri" \
  --tags Tag1=Value1
注意

帳單取決於您的使用情況。您可能會因使用其他AWS服務而產生費用。如需詳細資訊，請參閱 Amazon 定 Location Service 定價。

驗證您的請求

一旦您建立路由計算機資源，並準備好開始在應用程式中建置位置功能，請選擇驗證要求的方式：

  • 若要探索存取服務的方式，請參閱存取 Amazon 定 Location Service。

  • 如果您有一個擁有匿名用戶的網站，則可能需要使用 API 密鑰或 Amazon Cognito。

    範例

    下列範例顯示如何使用 API 金鑰進行授權、使用 JavaScriptAWS 開發套件 v3 和 Amazon 位置JavaScript 驗證助手。

    import { LocationClient, CalculateRouteCommand } from "@aws-sdk/client-location";
import { withAPIKey } from "@aws/amazon-location-utilities-auth-helper";

const apiKey = "v1.public.your-api-key-value"; // API key

// Create an authentication helper instance using an API key
const authHelper = await withAPIKey(apiKey);

const client = new LocationClient({
  region: "<region>", // region containing Cognito pool
  ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location
});

const input = {
  CalculatorName: "ExampleCalculator",
  DeparturePosition: [-123.4567, 45.6789],
  DestinationPosition: [-123.123, 45.234],
};

const command = new CalculateRouteCommand(input);

const response = await client.send(command);