Method: resolveMapsUrls

Rozwiązuje listę adresów URL Map Google na konkretne obiekty geoprzestrzenne (np. miejsca) w Mapach Google.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

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

Zapis JSON 
{
  "urls": [
    string
  ]
}
Pola
urls[]

string

Wymagane. Adresy URL Map Google do rozwiązania. Każdy adres URL powinien być prawidłowym adresem URL Map Google, np. https://maps.app.goo.gl/..., https://www.google.com/maps/place/... lub https://maps.google.com/.... Obecnie obsługiwane są tylko adresy URL wskazujące jedno miejsce. Możesz podać maksymalnie 20 adresów URL.

Treść odpowiedzi

Wiadomość odpowiedzi dla v1.resolveMapsUrls.

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

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

object (Entity)

Tylko dane wyjściowe. Lista rozwiązanych podmiotów z adresów URL w Mapach Google. Gwarantowane mapowanie 1:1 z indeksami żądania urls. Pusty komunikat w indeksie i (gdzie nie ustawiono entity) oznacza, że w przypadku tego adresu URL nie udało się uzyskać rozdzielczości. 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 błędach w przypadku adresów URL Map Google. Kluczem jest indeks nieudanej prośby w polu urls. 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