先決條件 - Amazon Location Service

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

先決條件

在開始地理編碼、反向地理編碼或搜索地點之前,請按照先決條件步驟操作:

建立位置索引資源

首先在您的AWS帳户。

創建位置索引資源時,可以從可用於支持地理編碼、反向地理編碼和搜索查詢的數據提供程序中進行選擇:

  1. 埃斯裏— 有關 Esri 在您感興趣地區的覆蓋範圍的詳細信息,請參閲Esri 地理編碼涵蓋本指南中的 。

  2. HERE HERE— 有關 HERE 在您感興趣地區的覆蓋範圍的詳細信息,請參閲HERE 地理編碼涵蓋本指南中的 。

您可以使用 Amazon Location Service 主控台、AWS CLI或亞馬遜位置 API。

Console

使用 Amazon Location Service 主控台建立位置索引資源

  1. 開啟 Amazon Location Servicehttps://console.aws.amazon.com/location/

  2. 在左側導覽窗格中,選擇放置索引

  3. 選擇建立位置索引

  4. 填寫以下方塊:

    • 名稱— 輸入地點索引資源的名稱。例如:示例索引。最多 100 個字元。有效條目包括英數字、連字號、句點和下劃線。

    • 描述 — 輸入選用描述。

  5. 根據數據提供商中,選擇一個可用數據提供程序與您的位置索引資源一起使用。

    注意

    如果您的應用程序正在跟蹤或路由您在業務中使用的資產,例如配送工具或員工,則只能將 HERE 用作地理定位提供商。如需詳細資訊,請參考AWS服務條款

  6. 根據資料儲存選項中,指定是否要存儲位置索引資源中的搜索結果。

  7. (選用) 在 Tags (標籤) 底下,輸入標籤 Key (金鑰)Value (值)。這會添加一個標籤您的新地方索引資源。如需詳細資訊,請參閱「」標記您的資源

  8. 選擇建立位置索引

API

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

使用CreatePlaceIndex操作來自亞馬遜定位 API。

以下是建立名為的位置索引資源的 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 命令。

以下範例會建立名為示例索引運用埃斯裏作為數據提供程序。

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

  • 如果您擁有匿名用户的網站,或者希望使用自己的身份驗證過程,或者結合多種身份驗證方法,請參閲允許未經身份驗證的來賓使用 Amazon Cognito 訪問您的應用程序

    範例

    以下示例顯示在使用AWS JavaScript 發套件

    const AWS = require("aws-sdk"); const credentials = new AWS.CognitoIdentityCredentials({ IdentityPoolId: "us-east-1:54f2ba88-9390-498d-aaa5-0d97fb7ca3bd" }); const client = new AWS.Location({ credentials, region: AWS.config.region // region containing the identity pool }); // rsp.Results contains search results for geocoding const rsp = await location.searchPlaceIndexForText({ IndexName: "ExamplePlaceIndex", Text: "Anyplace", BiasPosition: [-123.4567, 45.6789] }).promise();