Method: resolveMapsUrls

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

HTTP-запрос

POST https://mapstools.googleapis.com/v1alpha: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.

Тело ответа

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

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

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

object (Entity)

Только для вывода. Список объектов, полученных из URL Google Карт. Гарантируется сопоставление 1:1 с индексами 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