Method: resolveNames

Löst eine Liste von Ortsnamen (oder Adressen) in bestimmte geografische Einheiten (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 Ortsanfragen, die aufgelöst werden sollen. Sie können bis zu 20 Abfragen angeben.
locationBias

object (LocationBias)

Optional. Eine optionale Region, um die Auflösungsergebnisse zu beeinflussen. Falls angegeben, werden die Auflösungsergebnisse auf die Einheiten ausgerichtet, die sich näher an dieser Region befinden. Wenn Sie locationBias oder regionCode einfügen, werden oft bessere Ergebnisse erzielt, da der Suchbereich eingegrenzt 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: „US“ oder „CA“. Wenn Sie locationBias oder regionCode einfügen, werden oft bessere Ergebnisse erzielt, da der Suchbereich eingegrenzt 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. Die Zuordnung zu den queries-Indexen der Anfrage ist garantiert 1:1. Ein leerer String am Index i gibt an, dass die Auflösung für diese Anfrage fehlgeschlagen ist. Wenn die Auflösung fehlgeschlagen ist, sehen Sie im Feld failedRequests nach dem Fehlerstatus.
failedRequests

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

Nur Ausgabe. Eine Karte, auf der teilweise fehlgeschlagene Vorgänge dargestellt werden. 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, über den Sie alle erfolgreich aufgelösten Entitäten in Google Maps speichern können.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

LocationQuery

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

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

string

Erforderlich. Die Textanfrage, die in Google Maps in eine bestimmte geografische Einheit wie einen Ort oder eine Adresse aufgelöst werden soll. Je spezifischer die Anfrage, desto genauer die Lösung. Beispiele: „San Francisco“, „Googleplex, Mountain View, CA“, „1600 Amphitheatre Parkway, Mountain View, CA“ oder „Eiffelturm, Paris“. Anfragen müssen eine bestimmte Adresse oder einen bestimmten Ortsnamen enthalten. Allgemeine Standorte wie ein Kettenname (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 des Standort-Bias. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
viewport

object (Viewport)

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

Ergebnis

Eine einzelne aufgelöste Entität aus einer bestimmten Standortanfrage 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 Standortanfrage.
confidence

enum (Confidence)

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

Zuverlässigkeit

Das Konfidenzniveau für die Lösung.

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