Method: resolveMapsUrls

Преобразует список URL-адресов Google Maps в конкретные геопространственные объекты (например, места) на Google Maps.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "urls": [
    string
  ]
}
Поля
urls[]

string

Обязательно. URL-адреса Google Maps, которые необходимо разрешить. Каждый URL-адрес должен быть действительным URL-адресом Google Maps, например, https://maps.app.goo.gl/... , https://www.google.com/maps/place/... или https://maps.google.com/... . В настоящее время поддерживаются только URL-адреса, указывающие на одно место. Вы можете указать до 20 URL-адресов.

Ответный текст

Ответное сообщение для v1alpha.resolveMapsUrls.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
Поля
entities[]

object ( Entity )

Только вывод. Список разрешенных объектов по URL-адресам Google Maps. Гарантированное соответствие 1:1 с индексами urls запросов. Пустое сообщение по индексу i (где entity не задан) указывает на неудачную попытку разрешения для данного URL-адреса. Если разрешение не удалось, проверьте поле failedRequests для получения информации о статусе ошибки.

failedRequests

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

Только вывод. Карта, отображающая частичные сбои при доступе к URL-адресам Google Maps. Ключом является индекс неудачного запроса в поле urls . Значением является статус ошибки, подробно описывающий причину сбоя.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

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