快速入门使用Amazon LLocation Service on - Amazon Location Service

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

快速入门使用Amazon LLocation Service on

开始使用亚马逊Location Service 的最有效方法是使用亚马逊定位控制台。您可以创建和管理您的资源,并使用 “浏览” 页面试用亚马逊定位功能。

注意

要使用 Amazon Location Service 控制台或按照本教程的其余部分进行操作,需要您先完成使用Amazon Location Ser,包括创建AWS账户和允许访问 Amazon Location。

要开始学习 Amazon Location API,请使用以下教程创建一个显示交互式地图并使用搜索功能的简单应用程序。本教程向你展示如何使用 Kotlin 创建一个简单的网页 JavaScript,或者如何使用 Kotlin 创建一个 Android 应用程序。前几个步骤是两者共同的。

为您的应用程序创建亚马逊位置资源

如果您还没有,则必须创建应用程序将使用的Amazon Location资源。在这里,您可以创建用于在应用程序中显示地图的地图资源和用于在地图上搜索位置的地点索引。

向您的应用程序添加位置资源
  1. 选择要使用的地图样式。

    1. 在 Amazon Location 控制台的 “地图” 页面上,选择 “创建地图” 以预览地图样式。

    2. 为新地图资源添加名称描述。请记下用于地图资源的名称。在本教程后面创建脚本文件时,您将需要它。

    3. 选择地图。

      注意

      选择地图样式还会选择要使用的地图数据提供器。如果您的应用程序正在跟踪或路由您在企业中使用的资产,例如送货车辆或员工,则只能使用HERE作为地理定位提供商。有关更多信息,请参阅AWS服务条款的第 82 节。

    4. 同意亚马逊位置条款和条件,然后选择创建地图。您可以与所选地图进行交互:放大、缩小或向任意方向平移。

    5. 请记下新地图资源中显示的 Amazon Resource (ARN)。在本教程的稍后部分,您将使用它来创建正确的身份验证。

  2. 选择要使用的地点索引。

    1. 在 Amazon Location 控制台的 “地点索引” 页面上,选择 “创建地点索引”。

    2. 为新的地点索引资源添加名称描述。请记下用于地点索引资源的名称。在本教程后面创建脚本文件时,您将需要它。

    3. 选择数据提供者。

      注意

      在大多数情况下,选择与您已选择的地图提供商相匹配的数据提供商。这有助于确保搜索与地图相匹配。

      如果您的应用程序正在跟踪或路由您在企业中使用的资产,例如送货车辆或员工,则只能使用HERE作为地理定位提供商。有关更多信息,请参阅AWS服务条款的第 82 节。

    4. 选择数据存储选项。在本教程中,结果不存储,因此您可以选择 “否,仅限一次性使用”。

    5. 同意亚马逊位置条款和条件,然后选择创建地点索引

    6. 记下显示的新地点索引资源的 ARN。在本教程的下一节中,您将使用它来创建正确的身份验证。

为您的应用程序设置身份验证

您在本教程中创建的应用程序具有匿名用法,这意味着您的用户无需登录AWS即可使用该应用程序。但是,亚马逊Location Service API 需要身份验证才能使用。您可以使用 Amazon Cognito 为匿名用户提供身份验证和授权。您必须先创建一个 Amazon Cognito ento Concento Concento ConcentAmazon Cognito ento Conces

注意

有关将 Amazon Concento Concento ConcLocation Service授予对资源的Location Service cento Con

为您的应用程序设置身份验证
  1. 转到 Amazon Cognito 控制台

  2. 选择 Manage Identity Pools(管理身份池)。

  3. 选择 “创建新身份池”,然后输入身份池的名称。

    重要

    您创建的池必须与您在上一节中创建的亚马逊Location Service 资源位于相同的AWS 账户和AWS区域。

  4. 未认证身份可折叠部分中,选择启用对未经身份验证的身份的访问权限

  5. 选择 Create Pool(创建池)。

  6. 选择您希望用于身份池的 IAM 角色。

  7. 展开查看详情

  8. 在 “未经身份验证的身份” 下,输入角色名称。

  9. 展开 “查看策略文档” 部分,然后选择 “编辑” 以添加您的策略。

  10. 添加您授予对您的资源的访问权限。

    以下是地图、地点、跟踪器和路线的政策示例。要使用您自己的策略的示例,请替换区域和 Acac countID 占位符:

    以下ceservicement Locatcess Location Service ccatcess 为您在上一节中创建的资源提供正确的 ARN。如果您不记得这些 ARN,可以通过在 Amazon Location 控制台的地图页面或地点索引页面上选择相应的资源来找到它们。

    { "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 中使用政策并对其进行适当范围界定的更多信息,请参阅授予对资源的Location Service

  11. 选择 “允许” 创建您的身份池。

  12. 示例代码页面上,选择的平台JavaScript。然后复制或写下IdentityPoolId您稍后将在浏览器脚本中使用的内容。

下一步

现在您已创建您的Amazon Loceservice Locento Locess Locatce(Amazon Locess Locatce Locess Lo 本教程向您说明如何使用 Kotton 来创建 Web 应用程序 JavaScript,或使用 Kotton 的 Androd 应用程序。