Method: resolveMapsUrls

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

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

Тело запроса

Ниже приведена структура данных в теле запроса.

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

string

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

Тело ответа

Сообщение с ответом для v1.resolveMapsUrls.

Ниже приведена структура данных в ответе, полученном на запрос.

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

object (Entity)

Используется только для вывода. Список объектов, полученных из URL Google Карт. Гарантированно соответствует запросу urls. Пустое сообщение в индексе i (где не задано значение entity) означает, что не удалось распознать URL. Если разрешение не удалось, проверьте поле failedRequests на наличие статуса ошибки.
failedRequests

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

Используется только для вывода. Карта, содержащая информацию о частичных сбоях для URL Google Карт. Ключ – это индекс неудачного запроса в поле urls. Значение представляет собой статус ошибки, в котором указано, почему преобразование не удалось.

Объект содержит список из нескольких пар ("key": value). Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
saveToMapsUrl

string

Используется только для вывода. Ссылка для сохранения всех успешно распознанных объектов в Google Картах.

Области авторизации

Требуется следующая область действия OAuth:

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