Voraussetzungen

Bevor Sie mit der Geokodierung, der umgekehrten Geokodierung oder der Suche nach Orten beginnen, führen Sie die erforderlichen Schritte aus:

Erstellen einer Ortsindexressource

Erstellen Sie zunächst eine Ortsindex-Ressource in Ihrem AWS Konto.

Wenn Sie eine Ortsindexressource erstellen, können Sie aus den Datenanbietern wählen, die zur Unterstützung von Abfragen für Geokodierung, Reverse-Geokodierung und Suchen verfügbar sind:

1. Esri – Weitere Informationen zur Abdeckung von Esri in Ihrer relevanten Region finden Sie unter Abdeckung der Esri-Geocodierung in der Esri-Dokumentation.

2. HERE Technologies – Weitere Informationen zur Abdeckung von HERE in Ihrer relevanten Region finden Sie unter Abdeckung der HERE-Geokodierung in der HERE-Dokumentation.

3. Grab – Grab stellt Daten nur für Südostasien bereit. Weitere Informationen zur Abdeckung von Grab finden Sie unter Länder/Regionen und abgedecktes Gebiet in diesem Leitfaden.

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

Console

So erstellen Sie eine Ortsindexressource mit der Amazon Location Service-Konsole

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

2. Wählen Sie im linken Navigationsbereich Indizes platzieren aus.

3. Wählen Sie Ortsindex erstellen aus.

4. Füllen Sie die folgenden Felder aus:

   • Name – Geben Sie einen Namen für die Ortsindex-Ressource ein. Zum Beispiel ExamplePlaceIndex. 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 unter Datenanbieter einen verfügbaren Datenanbieter aus, der mit Ihrer Ortsindexressource verwendet werden soll.

   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.

6. Geben Sie unter Datenspeicheroptionen an, ob Sie Suchergebnisse aus Ihrer Ortsindexressource speichern möchten.

7. (Optional) Geben Sie unter Markierungen einen Tag Key (Schlüssel) und einen Value (Wert) ein. Dadurch wird ein Tag für Ihre neue Ortsindexressource hinzugefügt. Weitere Informationen finden Sie unter Markieren Ihrer Ressourcen.

8. Wählen Sie Ortsindex erstellen aus.

API

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

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

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

POST /places/v0/indexes
Content-type: application/json

{
   "DataSource": "Esri",
   "DataSourceConfiguration": { 
      "IntendedUse": "SingleUse"
   },
   "Description": "string",
   "IndexName": "ExamplePlaceIndex",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}

AWS CLI

So erstellen Sie eine Ortsindex-Ressource mit AWS CLI -Befehlen

Verwenden Sie den create-place-index-Befehl.

Im folgenden Beispiel wird eine Ortsindexressource namens ExamplePlaceIndex mit Esri als Datenanbieter erstellt.

aws location \
  create-place-index \
  --data-source "Esri" \
  --description "Example place index" \
  --index-name "ExamplePlaceIndex" \
  --tags Tag1=Value1

Anmerkung

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

Authentifizieren Ihrer Anforderungen

Sobald Sie eine Ortsindexressource erstellt haben und bereit sind, Standortfunktionen in Ihrer Anwendung zu erstellen, wählen Sie aus, wie Sie Ihre Anfragen 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, SearchPlaceIndexForTextCommand } 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 = {
    IndexName: "ExamplePlaceIndex",
    Text: "Anyplace",
    BiasPosition: [-123.4567, 45.6789]
  };
  
  const command = new SearchPlaceIndexForTextCommand(input);
  
  const response = await client.send(command);