Method: resolveNames

Rozpoznaje listę nazw miejsc (lub adresów) i przypisuje je do konkretnych elementów geoprzestrzennych (np. miejsc) 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 podać 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ą faworyzować elementy, które znajdują się bliżej tego regionu. Uwzględnienie locationBias lub regionCode często daje lepsze wyniki, ponieważ zawęża zakres wyszukiwania.

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

string

Opcjonalnie: Opcjonalny kod regionu, który wpływa na wyniki rozpoznawania. Jeśli podasz region, wyniki rozpoznawania będą faworyzować elementy, które znajdują się w podanym regionie lub w jego pobliżu. Powinien to być kod regionu CLDR. Na przykład „PL” lub „CA”. Uwzględnienie locationBias lub regionCode często daje lepsze wyniki, ponieważ zawęża zakres wyszukiwania.

Jeśli określono zarówno locationBias, jak i regionCode, locationBias ma pierwszeństwo przed 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 elementów z zapytań o lokalizację. Gwarantowane mapowanie 1:1 z indeksami żądania queries. Pusty ciąg znaków w indeksie i wskazuje, że nie udało się rozpoznać 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 zawierająca informacje o częściowych niepowodzeniach. Klucz to indeks nieudanego żądania w polu queries. Wartość to stan błędu, który szczegółowo opisuje, 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 rozpoznanych podmiotów w Mapach Google.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

LocationQuery

Zapytanie o lokalizację reprezentuje konkretną lokalizację, którą można znaleźć w Mapach Google. Obecnie jako zapytania o lokalizację obsługiwane są tylko nazwy i adresy miejsc.

Zapis JSON 
{
  "text": string
}
Pola
text

string

Wymagane. Zapytanie tekstowe, które ma zostać przekształcone w konkretny element geoprzestrzenny w Mapach Google, np. miejsce lub adres. Im bardziej szczegółowe zapytanie, tym dokładniejsze rozwiązanie. Na przykład „Warszawa”, „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, np. „restauracje”, nie są obsługiwane.

LocationBias

Region, który ma być preferowany w wynikach 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 lokalizacji. Poniżej znajduje się lista pól, które wzajemnie się 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ę wzajemnie.

Wynik

Pojedynczy rozpoznany element z danego zapytania o lokalizację wraz z poziomem ufności rozpoznania.

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

object (Entity)

Tylko dane wyjściowe. Rozpoznana encja z zapytania o lokalizację.
confidence

enum (Confidence)

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

Poziom ufności

Poziom ufności dla rozwiązania.

Wartości w polu enum
CONFIDENCE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
MEDIUM Średni poziom ufności oznacza, że rozwiązanie jest prawdopodobnie prawidłowe, ale mogą istnieć inne możliwości.
HIGH Wysoki poziom ufności oznacza, że rozwiązanie jest prawidłowe i reprezentuje konkretny element geoprzestrzenny (np. konkretne miejsce).