必要條件 - Amazon Location Service
建立位置索引資源驗證您的請求

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

必要條件

在開始進行地理編碼、反向地理編碼或搜尋地點之前，請遵循先決步驟：

建立位置索引資源

首先在您的 AWS 帳號中建立位置索引資源。

建立地點索引資源時，您可以從可用於支援地理編碼、反向地理編碼和搜尋查詢的資料提供者中進行選擇：

  1. Esri — 有關 Esri 在您感興趣的地區覆蓋範圍的更多信息，請參閱 Esri 文檔中的 Esri 地理編碼覆蓋範圍。

  2. HERE 技術 — 如需您感興趣地區 HERE 涵蓋範圍的詳細資訊，請參閱 HERE 文件中的 HERE 地理編碼涵蓋範圍。

  3. 抓取 — Grab 僅為東南亞提供資料。有關 Grab 覆蓋範圍的更多信息，請參閱本指南所涵蓋的國家 ／ 地區中的。

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

Console

使用 Amazon 定位服務主控台建立位置索引資源

  1. 在 https://console.aws.amazon.com/location/ 打開 Amazon 定 Location Service 控制台。

  2. 在左側導覽窗格中，選擇 [置入索引]。

  3. 選擇 [建立地點索引]。

  4. 填寫下列方塊：

    • 名稱 — 輸入位置索引資源的名稱。例如，ExamplePlaceIndex. 最多 100 個字元。有效的項目包括英數字元、連字號、句號和底線。

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

  5. 在「資料提供者」下，選擇可用的資料提供者，以與您的 place 索引資源搭配使用。

    注意

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

  6. 在「資料儲存選項」下，指定是否要儲存位置索引資源的搜尋結果。

  7. (選用) 在 Tags (標籤) 底下，輸入標籤 Key (金鑰) 與 Value (值)。這將添加一個標籤您的新位置索引資源。如需詳細資訊，請參閱標記您的資源。

  8. 選擇 [建立地點索引]。

API

若要使用 Amazon 位置 API 建立位置索引資源

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

下列範例是建立ExamplePlaceIndex使用資料提供者 Esri 呼叫的位置索引資源的 API 要求。

POST /places/v0/indexes
Content-type: application/json

{
   "DataSource": "Esri",
   "DataSourceConfiguration": { 
      "IntendedUse": "SingleUse"
   },
   "Description": "string",
   "IndexName": "ExamplePlaceIndex",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}
AWS CLI

使用指令建立位置索引資源的 AWS CLI 步驟

使用 create-place-index 命令。

下列範例會建立ExamplePlaceIndex使用 Esri 做為資料提供者呼叫的位置索引資源。

aws location \
  create-place-index \
  --data-source "Esri" \
  --description "Example place index" \
  --index-name "ExamplePlaceIndex" \
  --tags Tag1=Value1
注意

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

驗證您的請求

建立地點索引資源並準備好開始在應用程式中建置位置功能之後，請選擇驗證請求的方式：

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

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

    範例

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

    import { LocationClient, SearchPlaceIndexForTextCommand } 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 = {
  IndexName: "ExamplePlaceIndex",
  Text: "Anyplace",
  BiasPosition: [-123.4567, 45.6789]
};

const command = new SearchPlaceIndexForTextCommand(input);

const response = await client.send(command);