Method: resolveNames

Rozwiązuje listę nazw miejsc (lub adresów) na konkretne obiekty geoprzestrzenne (np. miejsca) w Mapach Google.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
Pola
queries[]

object (LocationQuery)

Wymagane. Lista zapytań o lokalizację do rozwiązania. Możesz określić maksymalnie 20 zapytań.
locationBias

object (LocationBias)

Opcjonalnie: Opcjonalny region, który ma wpływać na wyniki rozpoznawania. Jeśli jest określony, wyniki rozpoznawania będą bardziej ukierunkowane na podmioty znajdujące się bliżej tego regionu. Użycie symbolu locationBias lub regionCode często daje lepsze wyniki, ponieważ zawęża przestrzeń wyszukiwania.

Jeśli określono zarówno locationBias, jak i regionCode, pierwszeństwo ma locationBias.regionCode
regionCode

string

Opcjonalnie: Opcjonalny kod regionu, który ma wpływać na wyniki rozpoznawania. Jeśli zostanie określony, wyniki rozpoznawania będą bardziej ukierunkowane na podmioty znajdujące się w określonym regionie lub w jego pobliżu. Powinien to być kod regionu CLDR. Na przykład „US” lub „CA”. Użycie symbolu locationBias lub regionCode często daje lepsze wyniki, ponieważ zawęża przestrzeń wyszukiwania.

Jeśli określono zarówno locationBias, jak i regionCode, pierwszeństwo ma locationBias.regionCode

Treść odpowiedzi

Wiadomość z odpowiedzią dla v1.resolveNames.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
Pola
results[]

object (Result)

Tylko dane wyjściowe. Lista rozpoznanych podmiotów z zapytań o lokalizację. Gwarantowane mapowanie 1:1 z indeksami żądania queries. Pusty ciąg na pozycji i oznacza, że rozpoznawanie nie powiodło się w przypadku tego zapytania. Jeśli rozpoznanie się nie powiodło, sprawdź pole failedRequests, aby poznać stan błędu.
failedRequests

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

Tylko dane wyjściowe. Mapa informująca o częściowych niepowodzeniach. Kluczem jest indeks nieudanego żądania w polu queries. Wartość to stan błędu, który zawiera szczegółowe informacje o tym, dlaczego rozpoznanie się nie powiodło.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }
saveToMapsUrl

string

Tylko dane wyjściowe. link do zapisania wszystkich prawidłowo rozwiązanych encji w Mapach Google;

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

LocationQuery

Zapytanie o lokalizację reprezentuje konkretny obiekt lokalizacji, który można rozwiązać za pomocą Map Google. Obecnie jako zapytania o lokalizację obsługiwane są tylko nazwy miejsc i adresy.

Zapis JSON 
{
  "text": string
}
Pola
text

string

Wymagane. Zapytanie tekstowe, które ma zostać przekształcone w konkretny obiekt geoprzestrzenny w Mapach Google, np. miejsce lub adres. Im bardziej szczegółowe zapytanie, tym dokładniejsze rozwiązanie. Na przykład „San Francisco”, „Googleplex, Mountain View, CA”, „1600 Amphitheatre Parkway, Mountain View, CA” lub „Wieża Eiffla, Paryż”. Zapytania muszą zawierać konkretny adres lub nazwę miejsca. Ogólne lokalizacje, takie jak nazwa sieci (np. Starbucks) lub zapytanie „restauracje”, nie są obsługiwane.

LocationBias

Region, w którym mają być preferowane wyniki rozpoznawania.

Zapis JSON 
{

  // 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.
}
Pola
Typ odchylenia lokalizacji. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
viewport

object (Viewport)

Widoczny obszar zdefiniowany przez ramkę ograniczającą.
Koniec pól wykluczających się nawzajem.

Wynik

Pojedynczy rozwiązany podmiot z danego zapytania o lokalizację wraz z poziomem ufności rozwiązania.

Zapis JSON 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
Pola
entity

object (Entity)

Tylko dane wyjściowe. Rozwiązana encja z zapytania o lokalizację.
confidence

enum (Confidence)

Tylko dane wyjściowe. Poziom ufności rozwiązania.

Poziom ufności

Poziom ufności rozwiązania.

Wartości w polu enum
CONFIDENCE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
MEDIUM Średnia pewność oznacza, że rozwiązanie jest prawdopodobnie prawidłowe, ale mogą istnieć inne możliwości.
HIGH Wysoki poziom ufności oznacza, że rozdzielczość jest prawidłowa i odnosi się do konkretnego obiektu geoprzestrzennego (np. konkretnego miejsca).