本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
必要條件
在開始進行地理編碼、反向地理編碼或搜尋地點之前,請遵循先決步驟:
建立位置索引資源
首先在您的 AWS 帳號中建立位置索引資源。
建立地點索引資源時,您可以從可用於支援地理編碼、反向地理編碼和搜尋查詢的資料提供者中進行選擇:
-
Esri — 有關 Esri 在您感興趣的地區覆蓋範圍的更多信息,請參閱 Esri 文檔中的 Esri 地理編碼覆蓋範圍
。 -
HERE 技術 — 如需您感興趣地區 HERE 涵蓋範圍的詳細資訊,請參閱 HERE 文件中的 HERE 地理編碼涵蓋範圍
。 -
抓取 — Grab 僅為東南亞提供資料。有關 Grab 覆蓋範圍的更多信息,請參閱本指南所涵蓋的國家 / 地區及地區中的。
您可以使用 Amazon 定 Location Service 主控台 AWS CLI、或 Amazon 位置 API 來執行此操作。
注意
帳單取決於您的使用情況。您可能會因使用其他 AWS
服務而產生費用。如需詳細資訊,請參閱 Amazon 定 Location Service 定價
驗證您的請求
建立地點索引資源並準備好開始在應用程式中建置位置功能之後,請選擇驗證請求的方式:
-
若要探索存取服務的方式,請參閱存取 Amazon 定 Location Service。
-
如果您有一個擁有匿名用戶的網站,則可能需要使用 API 密鑰或 Amazon Cognito。
範例
下列範例顯示如何使用 API 金鑰進行授權、使用 JavaScriptAWS 開發套件 v3
和 Amazon 位置JavaScript 驗證助手。 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);