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/v1alpha: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 Standortanfragen, die aufgelöst werden müssen. 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 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. Wenn angegeben, werden die Auflösungsergebnisse auf die Einheiten in oder in der Nähe der angegebenen Region ausgerichtet. 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 v1alpha.resolveNames.

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

JSON-Darstellung 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
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 Fehler 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" }.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

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. Zum Beispiel „San Francisco“, „Googleplex, Mountain View, CA“, „1600 Amphitheatre Parkway, Mountain View, CA“ oder „Eiffelturm, Paris“. Abfragen 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 
{

  // Union field type can be only one of the following:
  "viewport": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Felder
Union-Feld type. Der Typ des Standort-Bias. Für type ist nur einer der folgenden Werte zulässig:
viewport

object (Viewport)

Ein Darstellungsbereich, der durch einen Begrenzungsrahmen definiert wird.

Darstellungsbereich

Ein Sichtfeld, das durch zwei diagonal gegenüberliegende Punkte low und high dargestellt wird. Ein Darstellungsbereich gilt als geschlossene Region, d.h., er umfasst seine Grenze. Die Breitengradgrenzen müssen zwischen -90 und 90 Grad liegen (einschließlich), und die Längengradgrenzen müssen zwischen -180 und 180 Grad liegen (einschließlich). Dazu gehören:

  • Wenn low = high ist, besteht der Darstellungsbereich aus diesem einzelnen Punkt.

  • Wenn low.longitude > high.longitude, wird der Längengradbereich umgekehrt (der Darstellungsbereich überschreitet die 180-Grad-Längengradlinie).

  • Wenn low.longitude = -180 Grad und high.longitude = 180 Grad ist, umfasst das Sichtfeld alle Längengrade.

  • Wenn low.longitude = 180 Grad und high.longitude = -180 Grad, ist der Längengradbereich leer.

  • Wenn low.latitude > high.latitude, ist der Breitengradbereich leer.

Sowohl low als auch high müssen ausgefüllt sein und das dargestellte Rechteck darf nicht leer sein (siehe Definitionen oben). Ein leerer Viewport führt zu einem Fehler.

Beispiel: Dieser Viewport umfasst New York City vollständig:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON-Darstellung 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Felder
low

object (LatLng)

Erforderlich. Der niedrigste Punkt des Darstellungsbereichs.
high

object (LatLng)

Erforderlich. Der höchste Punkt des Darstellungsbereichs.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Dies wird als Paar aus Werten vom Typ „Double“ (Breiten- und Längengrad) ausgedrückt. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

JSON-Darstellung 
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.
longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

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 Einheit 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 „Mittlere Zuverlässigkeit“ bedeutet, dass die Auflösung wahrscheinlich richtig ist, es aber auch andere Möglichkeiten gibt.
HIGH Ein hohes Konfidenzniveau bedeutet, dass die Auflösung korrekt ist und ein bestimmtes geografisches Objekt (z.B. ein bestimmter Ort) darstellt.