Method: resolveNames

Löst eine Liste von Ortsnamen (oder Adressen) in bestimmte Geodaten-Entitäten (z.B. Orte) in Google Maps auf.

HTTP-Anfrage

POST https://mapstools.googleapis.com/v1:resolveNames

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
Felder
queries[]

object (LocationQuery)

Erforderlich. Eine Liste der aufzulösenden Standortabfragen. Sie können bis zu 20 Abfragen angeben.
locationBias

object (LocationBias)

Optional. Eine optionale Region, um die Auflösungsergebnisse zu beeinflussen. Wenn angegeben, werden die Auflösungsergebnisse auf die Entitäten ausgerichtet, die sich näher an dieser Region befinden. Wenn Sie locationBias oder regionCode angeben, erhalten Sie oft bessere Ergebnisse, da der Suchbereich eingeschränkt wird.

Wenn sowohl locationBias als auch regionCode angegeben sind, hat locationBias Vorrang vor regionCode.
regionCode

string

Optional. Ein optionaler Regionscode, um die Auflösungsergebnisse zu beeinflussen. Falls angegeben, werden die Auflösungsergebnisse auf die Entitäten ausgerichtet, die sich in oder in der Nähe der angegebenen Region befinden. Dies sollte ein CLDR-Regionscode sein. Beispiel: „DE“ oder „AT“. Wenn Sie locationBias oder regionCode angeben, erhalten Sie oft bessere Ergebnisse, da der Suchbereich eingeschränkt wird.

Wenn sowohl locationBias als auch regionCode angegeben sind, hat locationBias Vorrang vor regionCode.

Antworttext

Antwortnachricht für v1.resolveNames.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
Felder
results[]

object (Result)

Nur Ausgabe. Die Liste der aufgelösten Entitäten aus den Standortabfragen. Wird garantiert 1:1 den queries-Indizes der Anfrage zugeordnet. Ein leerer String am Index i gibt an, dass die Auflösung für diese Abfrage fehlgeschlagen ist. Wenn die Auflösung fehlgeschlagen ist, prüfen Sie das Feld failedRequests auf den Fehlerstatus.
failedRequests

map (key: integer, value: object (Status))

Nur Ausgabe. Eine Karte, die teilweise fehlgeschlagene Vorgänge zeigt. Der Schlüssel ist der Index der fehlgeschlagenen Anfrage im Feld queries. Der Wert ist der Fehlerstatus, der angibt, warum die Auflösung fehlgeschlagen ist.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
saveToMapsUrl

string

Nur Ausgabe. Ein Link zum Speichern aller erfolgreich aufgelösten Entitäten in Google Maps.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/maps-platform.mapstools

LocationQuery

Eine Standortabfrage stellt eine bestimmte Standortentität dar, die mit Google Maps aufgelöst werden kann. Derzeit werden nur Ortsnamen und Adressen als Standortabfragen unterstützt.

JSON-Darstellung 
{
  "text": string
}
Felder
text

string

Erforderlich. Die Textanfrage, die in ein bestimmtes Georaumobjekt in Google Maps aufgelöst werden soll, z. B. einen Ort oder eine Adresse. Je genauer die Anfrage, desto genauer die Lösung. Beispiele: „San Francisco“, „Googleplex, Mountain View, CA“, „1600 Amphitheatre Parkway, Mountain View, CA“ oder „Eiffelturm, Paris“. Suchanfragen müssen eine bestimmte Adresse oder ein bestimmter Ortsname sein. Ungefähre Orte wie der Name einer Kette (z.B. Starbucks) oder eine Suchanfrage wie „Restaurants“ werden nicht unterstützt.

LocationBias

Die Region, auf die die Auflösungsergebnisse ausgerichtet werden sollen.

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "viewport": {
    object (Viewport)
  }
  // End of mutually exclusive fields.
}
Felder
Der Typ der Standortgewichtung. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
viewport

object (Viewport)

Ein Darstellungsbereich, der durch einen Begrenzungsrahmen definiert ist.
Ende der sich gegenseitig ausschließenden Felder.

Ergebnis

Eine einzelne aufgelöste Entität aus einer bestimmten Standortabfrage zusammen mit dem Konfidenzniveau der Auflösung.

JSON-Darstellung 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
Felder
entity

object (Entity)

Nur Ausgabe. Die aufgelöste Entität aus der Standortabfrage.
confidence

enum (Confidence)

Nur Ausgabe. Das Konfidenzniveau für die Auflösung.

Zuverlässigkeit

Das Konfidenzniveau für die Auflösung.

Enums
CONFIDENCE_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
MEDIUM Eine mittlere Konfidenz bedeutet, dass die Auflösung wahrscheinlich korrekt ist, es aber auch andere Kandidaten geben kann.
HIGH Eine hohe Konfidenz bedeutet, dass die Auflösung korrekt ist und ein bestimmtes geografisches Objekt (z.B. einen bestimmten Ort) darstellt.