先决条件

在开始计算路径之前，请遵循先决步骤：

创建路由计算器资源

在计算路由之前，请在您的AWS账户中创建路由计算器资源。

创建路径计算器资源时，可以从可用的数据提供者中进行选择：

1. Esri-有关 Esri 在您感兴趣区域中的覆盖范围的更多信息，请参阅有关街道网络和交通覆盖范围的 Esri 详细信息。

2. HERE Technologies-有关 HERE 在您感兴趣区域中的覆盖范围的更多信息，请参阅 HERE 汽车的路由覆盖范围。

3. Grab — 有关 Grab 报道的更多信息，请参阅覆盖的国家和地区。

注意

如果您的应用程序正在跟踪或路由您在企业中使用的资产，例如运载车辆或员工，则不得使用 Esri 作为地理位置提供商。有关更多详细信息，请参阅 AWS 服务条款的第 82 节。

您可以使用Amazon Location SocatiLocation Service olocAWS CLI ation Solocation Solocation

Console

使用亚马逊位置控制台创建路线计算器资源

1. 通过 https://console.aws.amazon.com/location/ 打开亚马逊定位控制台。

2. 在左侧导航窗格中，选择 Routing 计算器。

3. 选择创建路线计算器。

4. 填写以下方框：

   • 名称 — 输入路径计算器资源的名称。例如，ExampleCalculator。最多 100 个字符。有效条目包括字母数字字符、连字符、句点和下划线。

   • 描述-输入可选描述。

5. 对于数据提供者，请选择一个数据提供者用作路径计算器。

6. （可选）在 Tags (标签) 下，输入标签 Key (键) 和 Value (值)。这会为您的新路线计算器资源添加标签。有关更多信息，请参阅标记资源。

7. 选择创建路线计算器。

API

使用亚马逊位置 API 创建路线计算器资源

使用 Amazon Location Places API 中的CreateRouteCalculator操作。

以下示例是ExampleCalculator使用数据提供商 Esri 创建名为的路径计算器资源的 API 请求。

POST /routes/v0/calculators
Content-type: application/json

{
   "CalculatorName": "ExampleCalculator",
   "DataSource": "Esri",
   "Description": "string",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}

AWS CLI

使用AWS CLI命令创建路由计算器资源

使用 create-route-calculator 命令。

以下示例ExampleCalculator使用 Esri 作为数据提供者创建名为的路径计算器资源。

aws location \
  create-route-calculator \
  --calculator-name "ExampleCalculator" \
  --data-source "Esri" \
  --tags Tag1=Value1

注意

计费取决于您的使用情况。您可能会因使用其他AWS服务而产生费用。有关更多信息，请参阅 Amazon LocatiLocation Service cat ion

对您的请求进行身份验证

创建路径计算器资源并准备好开始在应用程序中构建位置功能后，请选择如何验证您的请求：

• 要探索访问服务的方式，请参阅访问亚马逊Location Servic e。

• 如果您的网站有匿名用户，或者您想使用自己的身份验证流程或组合多种身份验证方法，请参阅允许未经身份验证的访客使用 Amazon Cognito 访问您的应用程序。

  示例

  以下示例显示了在使用 AWS JavaScript SDK 时将未经身份验证的身份池作为证书传递的情况。

  const AWS = require("aws-sdk");
  
  const credentials = new AWS.CognitoIdentityCredentials({
     IdentityPoolId: "us-east-1:54f2ba88-9390-498d-aaa5-0d97fb7ca3bd"
  });
  
  const location = new AWS.Location({
     credentials,
     region: AWS.config.region // region containing Cognito pool
  });
  
  // rsp.Results contains calculated route
  const rsp = await location.calculateRoute({
      CalculatorName: "ExampleCalculator",
      DeparturePosition: [-123.4567, 45.6789],
      DestinationPosition: [-123.123, 45.234]
  }).promise();