Voraussetzungen für Orte, die Amazon Location verwenden - Amazon Location Service
Eine Ortsindex-Ressource erstellenAuthentifizierung Ihrer Anfragen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Voraussetzungen für Orte, die Amazon Location verwenden

Bevor Sie mit der Geokodierung, der umgekehrten Geokodierung oder der Suche nach Orten beginnen, folgen Sie den erforderlichen Schritten:

Erstellen einer Ortsindex-Ressource

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

Wenn Sie eine Ortsindex-Ressource erstellen, können Sie aus den verfügbaren Datenanbietern wählen, die Abfragen für Geokodierung, umgekehrte Geokodierung und Suchen unterstützen:

  1. Esri — Weitere Informationen zur Abdeckung von Esri in Ihrer Interessenregion finden Sie in der Esri-Dokumentation unter Geokodierung von Esri.

  2. HERETechnologien — Weitere Informationen HERE zur Abdeckung in Ihrer Interessenregion finden Sie in der Dokumentation unter HEREGeokodierung der Abdeckung. HERE

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

Sie können dies über die Amazon Location Service Service-Konsole AWS CLI, den oder den Amazon-Standort tunAPIs.

Console

So erstellen Sie eine Ortsindex-Ressource mit der Amazon Location Service Service-Konsole

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

  2. Wählen Sie im linken Navigationsbereich die Option 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. Zulässige 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, den Sie mit Ihrer Ortsindexressource verwenden möchten.

    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 Ihrer neuen Ortsindex-Ressource ein Tag hinzugefügt. Weitere Informationen finden Sie unter Markieren Ihrer Ressourcen.

  8. Wählen Sie Ortsindex erstellen.

API

So erstellen Sie eine Ortsindex-Ressource mithilfe des Amazon-Standorts APIs

Verwenden Sie den CreatePlaceIndex Vorgang von Amazon Location Places ausAPIs.

Das folgende Beispiel ist eine API Anfrage zur Erstellung einer Ortsindex-Ressource namens ExamplePlaceIndex unter Verwendung des Datenproviders Esri.

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

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

Um eine Ortsindex-Ressource mithilfe von AWS CLI Befehlen zu erstellen

Verwenden Sie den create-place-index-Befehl.

Im folgenden Beispiel wird eine Ortsindex-Ressource mit dem Namen erstellt ExamplePlaceIndex verwenden Esri als Datenanbieter. 

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

Die Abrechnung hängt von Ihrer Nutzung ab. Für die Nutzung anderer AWS Dienste können Gebühren anfallen. Weitere Informationen finden Sie unter Amazon Location Service — Preise.

Authentifizierung Ihrer Anfragen

Sobald Sie eine Ortsindex-Ressource erstellt haben und bereit sind, Standortfunktionen in Ihre Anwendung zu integrieren, wählen Sie aus, wie Sie Ihre Anfragen authentifizieren möchten:

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

  • Wenn Sie eine Website mit anonymen Benutzern haben, möchten Sie möglicherweise API Keys oder Amazon Cognito verwenden.

    Beispiel

    Das folgende Beispiel zeigt die Verwendung eines API Schlüssels für die Autorisierung mit AWS JavaScriptSDKv3 und dem Amazon-StandortJavaScript 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);