Voraussetzungen

Bevor Sie mit der Berechnung von Routen beginnen, führen Sie die erforderlichen Schritte aus:

Erstellen einer Routenrechner-Ressource

Bevor Sie eine Route berechnen können, erstellen Sie eine Routenrechner-Ressource in Ihrem AWS Konto.

Wenn Sie eine Routenrechner-Ressource erstellen, können Sie aus den verfügbaren Datenanbietern wählen:

1. Esri – Weitere Informationen zur Abdeckung von Esri in Ihrer relevanten Region finden Sie unter Esri-Details zu Straßennetzen und Verkehrsabdeckung.

2. HERE Technologies – Weitere Informationen zur Abdeckung von HERE in Ihrer relevanten Region finden Sie unter HERE-Abdeckung für das Auto-Routing und HERE-Abdeckung für das Lkw-Routing.

3. Grab – Weitere Informationen zur Abdeckung von Grab finden Sie unter Länder/Regionen und abgedecktes Gebiet.

Anmerkung

Wenn Ihre Anwendung Assets, die Sie in Ihrem Unternehmen verwenden, wie z. B. Lieferfahrzeuge oder Mitarbeiter, verfolgt oder weiterleitet, dürfen Sie Esri nicht als Geolokalisierungsanbieter verwenden. Weitere Informationen finden Sie in Abschnitt 82 der AWS-Servicebedingungen.

Sie können dies über die Amazon Location Service-Konsole, die AWS CLIoder die Amazon Location APIs tun.

Console

So erstellen Sie eine Routenrechner-Ressource mit der Amazon Location-Konsole

1. Öffnen Sie die Amazon Location-Konsole unter https://console.aws.amazon.com/location/.

2. Wählen Sie im linken Navigationsbereich Routenrechner aus.

3. Wählen Sie Routenrechner erstellen aus.

4. Füllen Sie die folgenden Felder aus:

   • Name – Geben Sie einen Namen für die Routenrechner-Ressource ein. Zum Beispiel ExampleCalculator. Maximal 100 Zeichen. Gültige Einträge umfassen alphanumerische Zeichen, Bindestriche, Punkte und Unterstriche.

   • Beschreibung – Geben Sie eine optionale Beschreibung ein.

5. Wählen Sie für Datenanbieter einen Datenanbieter aus, der als Routenrechner verwendet werden soll.

6. (Optional) Geben Sie unter Markierungen einen Tag Key (Schlüssel) und einen Value (Wert) ein. Dadurch wird ein Tag zu Ihrer neuen Routenrechner-Ressource hinzugefügt. Weitere Informationen finden Sie unter Markieren Ihrer Ressourcen.

7. Wählen Sie Routenrechner erstellen aus.

API

So erstellen Sie eine Routenrechner-Ressource mithilfe der Amazon Location APIs

Verwenden Sie die -CreateRouteCalculatorOperation aus den Amazon Location Places APIs .

Das folgende Beispiel ist eine API-Anforderung zum Erstellen einer Routenrechner-Ressource mit dem Namen ExampleCalculator unter Verwendung des Datenanbieters Esri .

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

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

AWS CLI

So erstellen Sie eine Routenrechner-Ressource mit -AWS CLIBefehlen

Verwenden Sie den create-route-calculator-Befehl.

Im folgenden Beispiel wird eine Routenrechner-Ressource namens ExampleCalculator mit Esri als Datenanbieter erstellt.

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

Anmerkung

Die Fakturierung hängt von Ihrer Nutzung ab. Möglicherweise fallen Gebühren für die Nutzung anderer -AWSServices an. Weitere Informationen finden Sie unter Amazon Location Service – Preise.

Authentifizieren Ihrer Anforderungen

Sobald Sie eine Routenrechner-Ressource erstellt haben und bereit sind, Standortfunktionen in Ihrer Anwendung zu erstellen, wählen Sie aus, wie Sie Ihre Anforderungen authentifizieren würden:

• Informationen dazu, wie Sie auf die Services zugreifen können, finden Sie unter Zugriff auf Amazon Location Service.

• Wenn Sie eine Website mit anonymen Benutzern haben, können Sie API-Schlüssel oder Amazon Cognito verwenden.

  Beispiel

  Das folgende Beispiel zeigt die Verwendung eines API-Schlüssels für die Autorisierung mit AWS JavaScript SDK v3 und dem Amazon Location JavaScript Authentifizierungshelfer.

  import { LocationClient, CalculateRouteCommand } 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 = {
    CalculatorName: "ExampleCalculator",
    DeparturePosition: [-123.4567, 45.6789],
    DestinationPosition: [-123.123, 45.234],
  };
  
  const command = new CalculateRouteCommand(input);
  
  const response = await client.send(command);