使用 Amazon Location 地图的先决条件
在开始使用 Amazon Location Service 的地图功能之前,需要满足几个先决条件。本页概述了确保将交互式地图顺利集成到应用程序中的必要步骤和要求。
创建地图资源
要在应用程序中使用地图,您必须拥有地图资源,该资源用于指定要在地图中使用的地图样式和数据提供程序。
如果您的应用程序正在跟踪或路由您在企业中使用的资产,例如运载车辆或员工,则不得使用 Esri 作为地理位置提供程序。有关更多详细信息,请参阅 AWS 服务条款的第 82 节。
您可以使用 Amazon Location Service 控制台、AWS CLI 或 Amazon Location API 创建地图资源。
- Console
-
使用 Amazon Location Service 控制台创建地图资源
-
在 Amazon Location 控制台的地图页面上,选择创建地图以预览地图样式。
-
为新地图资源添加名称和描述。
-
选择地图样式。
如果您的应用程序正在跟踪或路由您在企业中使用的资产,例如运载车辆或员工,则不得使用 Esri 作为地理位置提供程序。有关更多详细信息,请参阅 AWS 服务条款的第 82 节。
-
从 政治观点 中选择以使用。
-
同意 Amazon Location 条款和条件,然后选择创建地图。您可以与所选地图进行交互:放大、缩小或向任意方向平移。
-
要允许用户切换样式(例如,允许他们在卫星图像和矢量样式之间切换),必须为每种样式创建地图资源。
您可以在控制台的地图主页上删除不想使用的地图样式的资源。
- API
-
使用 Amazon Location API 创建地图资源
使用 Amazon Location API 中的 CreateMap
操作。
以下示例是使用 VectorEsriStreets
地图样式创建名为 ExampleMap
的地图资源的 API 请求。
POST /maps/v0/maps HTTP/1.1
Content-type: application/json
{
"Configuration": {
"Style": "VectorEsriStreets
"
},
"MapName": "ExampleMap
"
}
}
如果您的应用程序正在跟踪或路由您在企业中使用的资产,例如运载车辆或员工,则不得使用 Esri 作为地理位置提供程序。有关更多详细信息,请参阅 AWS 服务条款的第 82 节。
- AWS CLI
-
使用 AWS CLI 命令创建地图资源
使用 create-map
命令。
以下示例使用 VectorEsriStreets
作为地图样式创建了一个名为 ExampleMap
的地图资源。
aws location \
create-map \
--configuration Style="VectorEsriStreets
" \
--map-name "ExampleMap
"
如果您的应用程序正在跟踪或路由您在企业中使用的资产,例如运载车辆或员工,则不得使用 Esri 作为地理位置提供程序。有关更多详细信息,请参阅 AWS 服务条款的第 82 节。
对您的请求进行身份验证
创建地图资源并准备开始在应用程序中构建位置要素后,您需要选择如何对请求进行身份验证。
大多数地图前端应用程序都需要在未经身份验证的情况下访问 Amazon Location Service 的地图或其他功能。根据您的应用程序,您可能需要使用 AWS Signature v4 对请求进行身份验证,也可以使用 Amazon Cognito 或 Amazon Location API 密钥进行未经身份验证的使用。要了解有关所有这些选项的更多信息,请参阅 授予使用 Amazon Location Service。