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/v1alpha: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ę, które mają zostać rozwiązane. Możesz określić maksymalnie 20 zapytań.
locationBias

object (LocationBias)

Opcjonalnie. Opcjonalny region, który ma wpływać na wyniki rozdzielczości. Jeśli zostanie określony, wyniki rozpoznawania będą bardziej dopasowane do jednostek znajdujących 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 parametr locationBias, jak i regionCode, parametr locationBias ma pierwszeństwo przed parametrem regionCode.
regionCode

string

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

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

Treść odpowiedzi

Wiadomość z odpowiedzią dla v1alpha.resolveNames.

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

Zapis JSON 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
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 w indeksie i oznacza, że rozpoznawanie w przypadku tego zapytania nie powiodło się. Jeśli rozpoznanie się nie powiodło, sprawdź pole failedRequests pod kątem stanu błędu.
failedRequests

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

Tylko dane wyjściowe. Mapa pokazująca częściowe niepowodzenia. Kluczem jest indeks nieudanego żądania w polu queries. Wartość to stan błędu zawierający 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" }

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

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 wyszukiwania, np. „restauracje”, nie są obsługiwane.

LocationBias

Region, w którym mają być wyświetlane wyniki rozdzielczości.

Zapis JSON 
{

  // Union field type can be only one of the following:
  "viewport": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Pola
Pole zbiorcze type. Typ odchylenia lokalizacji. type może mieć tylko jedną z tych wartości:
viewport

object (Viewport)

Widoczny obszar zdefiniowany przez ramkę ograniczającą.

Widoczny obszar

Widoczny obszar określony przez szerokość i długość geograficzną, reprezentowany przez 2 przeciwległe punkty low i high. Widoczny obszar jest uważany za region zamknięty, czyli obejmuje swoje granice. Granice szerokości geograficznej muszą mieścić się w zakresie od -90 do 90 stopni włącznie, a granice długości geograficznej – od -180 do 180 stopni włącznie. Przykłady:

  • Jeśli low = high, widoczny obszar składa się z tego jednego punktu.

  • Jeśli low.longitude > high.longitude, zakres długości geograficznej jest odwrócony (widoczny obszar przekracza linię długości geograficznej 180 stopni).

  • Jeśli low.longitude = -180 stopni, a high.longitude = 180 stopni, widoczny obszar obejmuje wszystkie długości geograficzne.

  • Jeśli low.longitude = 180 stopni, a high.longitude = -180 stopni, zakres długości geograficznej jest pusty.

  • Jeśli low.latitude > high.latitude, zakres szerokości geograficznej jest pusty.

Wartości low i high muszą być wypełnione, a reprezentowane pole nie może być puste (zgodnie z powyższymi definicjami). Pusty obszar wyświetlania spowoduje błąd.

Na przykład ten widoczny obszar w całości obejmuje Nowy Jork:

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

Zapis JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Pola
low

object (LatLng)

Wymagane. Najniższy punkt widocznego obszaru.
high

object (LatLng)

Wymagane. Najwyższy punkt obszaru widocznego.

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest to para liczb zmiennoprzecinkowych podwójnej precyzji, które reprezentują stopnie szerokości i długości geograficznej. O ile nie określono inaczej, ten obiekt musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w znormalizowanych zakresach.

Zapis JSON 
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie od –90,0 do +90,0.
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie od –180,0 do +180,0.

Wynik

Pojedynczy rozpoznany podmiot 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. 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 Średni poziom ufności oznacza, że rozwiązanie jest prawdopodobnie prawidłowe, ale mogą istnieć inne kandydatury.
HIGH Wysoki poziom ufności oznacza, że rozdzielczość jest prawidłowa i odnosi się do konkretnego obiektu geoprzestrzennego (np. konkretnego miejsca).