Amazon Location Service 快速入門 - Amazon Location Service

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

Amazon Location Service 快速入門

開始使用 Amazon Location Service 的最有效方式就是使用Amazon Location Console。您可以創建和管理您的資源,並使用瀏覽頁面

注意

要使用亞馬遜 Location Service 控制台,或遵循本教程的其餘部分,需要您首先完成使用 Amazon Location Service 的先決條件,包括創建AWS賬户,並允許訪問亞馬遜地點。

要開始瞭解 Amazon 位置 API,請使用以下教程創建顯示交互式地圖並使用搜索功能的簡單應用程序。本教學課程介紹如何使用 JavaScript 或使用 Kotlin 建立安卓應用程式的簡易網頁。前幾個步驟對兩者都是共同的。

為您的應用程式建立 Amazon Location 資源

如果您尚未擁有資源,則必須建立您的應用程式將使用的 Amazon Location Service (Amazon Location) 資源。在這裏,您可以創建地圖資源以在應用程序中顯示地圖,並創建一個位置索引來搜索地圖上的位置。

將位置資源添加到您的應用程式

  1. 選擇您想要使用的地圖樣式。

    1. 在亞馬遜位置控制台中,在地圖」頁面上,選擇創建地圖以預覽地圖樣式。

    2. 新增名稱描述以獲取新地圖資源。請記下您用於地圖資源的名稱。在本教程後面的創建腳本文件時,您將需要它。

    3. 選擇地圖。

      注意

      選擇地圖樣式還會選擇要使用的地圖數據提供程序。如果您的應用程序正在跟蹤或路由您在業務中使用的資產,例如配送工具或員工,則您只能將此處用作地理定位提供商。如需詳細資訊,請參AWS服務條款

    4. 同意Amazon Location Service,然後選擇創建地圖。您可以與選擇的地圖進行交互:放大、縮小或在任意方向平移。

    5. 請記下為您的新地圖資源顯示的 Amazon 資源名稱 (ARN)。本教學課程稍後,您將使用它來建立正確的身分。

  2. 選擇您想要使用的位置索引。

    1. 在亞馬遜位置控制台上放置索引」頁面上,選擇建立位置索引

    2. 新增名稱描述以獲取新的地方索引資源。請記下您使用的位置索引資源的名稱。在本教程後面的創建腳本文件時,您將需要它。

    3. 選擇數據提供程序。

      注意

      在大多數情況下,請選擇與您已選擇的地圖提供程序匹配的數據提供程序。這有助於確保搜索結果與地圖相匹配。

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

    4. 選擇資料儲存體。對於本教程,不存儲結果,因此您可以選擇否,僅限一次性使用

    5. 同意Amazon Location Service,然後選擇建立位置索引

    6. 請記下為新地點索引資源顯示的 ARN。您將使用它在本教學課程的下一節建立正確的身分。

為應用程序設置身份驗證

您在本教程中創建的應用程序具有匿名用法,這意味着您的用户無需登錄AWS以使用該應用程序。但是,亞馬遜 Location Service API 需要身份驗證才能使用。您可以使用 Amazon Cognito 為匿名用户提供身份驗證和授權。您必須先建立 Amazon Cognito 身分集區,然後才能在您的應用程式中使用 Amazon Cognito 身分集區。

注意

如需使用 Amazon Cognito 與 Amazon Location Service 結合使用的詳細資訊,請參授予 Amazon Location Service 的存取

為應用程序設置身份驗證

  1. 前往 Amazon Cognito 主控台

  2. 選擇 Manage Identity Pools (管理身分集區)

  3. 選擇建立新的身分集區,然後輸入身分集區的名稱。

    重要

    您建立的集區必須在相同的AWS 帳戶和AWSLocation Service (Amazon Location Service) 資源,您在上一節建立的

  4. 未驗證的身分可摺疊部分,選擇啟用未經驗證身分的存取

  5. 選擇 Create Pool (建立集區)。

  6. 選擇要用於身份池的 IAM 角色。

  7. Expand檢視詳細資訊

  8. UNDERS未驗證的身分中,輸入角色名稱。

  9. 展開複製政策文件部分,然後選擇Edit (編輯)以添加您的策略。

  10. 新增政策以授權存取資源。

    以下是「地圖」、「地點」、「跟蹤器」和「路由」的策略示例。要為您自己的策略使用示例,請將區域accountID佔位置:

    以下政策授與 Amazon Location Service 資源的唯讀存取權。請為您在上一節建立的資源提供正確的 ARN。如果您不記得 ARN,您可以通過在亞馬遜位置控制台上選擇相應的資源來查找它們地圖頁面或放置索引(憑證已建立!) 頁面上的名稱有些許差異。

    { "Version": "2012-10-17", "Statement": [ { "Sid": "LocationReadOnly", "Effect": "Allow", "Action": [ "geo:GetMapStyleDescriptor", "geo:GetMapGlyphs", "geo:GetMapSprites", "geo:GetMapTile", "geo:SearchPlaceIndex*" ], "Resource": [ "arn:aws:geo:<region>:<accountID>:map/<ExampleMap>", "arn:aws:geo:<region>:<accountID>:place-index/<ExamplePlaceIndex>" ] } ] }
    注意

    雖然未經身份驗證的身份池旨在用於在不安全的互聯網站點上暴露,但請注意,它們將被交換為標準的、有時間限制的AWS登入資料。

    對於與未經身份驗證的身份池相關聯的 IAM 角色進行適當的範圍,這一點非常重要。有關通過亞馬遜 Location Service 在 Amazon Cognito 中使用和適當界定政策範圍的更多信息,請參閲授予 Amazon Location Service 的存取

  11. 選擇Allow創建您的身份池。

  12. 範本程式碼頁面上,選擇平台JavaScript。然後,複製或寫下IdentityPoolId,您稍後將在瀏覽器腳本中使用。

下一步驟

既然您已建立 Amazon Location Service 和 Amazon Cognito 資源,下一步是使用這些資源建立您的應用程式。本教學課程示範如何使用 JavaScript 建立 Web 應用程式,或使用 Kotlin 的 Android 應用程式。