Обзор API матрицы расстояний

Разработчики Европейской экономической зоны (ЕЭЗ)

Введение

Distance Matrix API (устаревшая версия) — это сервис, принимающий HTTPS-запросы, содержащие данные о пунктах отправления и назначения для заданного вида транспорта. Для каждой комбинации пунктов отправления и назначения он возвращает расстояние и продолжительность поездки.

Зачем использовать API матрицы расстояний

Вы можете использовать API Distance Matrix для определения наиболее эффективных маршрутов между несколькими возможными пунктами отправления и назначения. Например, каких рабочих отправлять на строительные площадки или с каких складов отправлять посылки.

Что можно сделать с помощью API Distance Matrix

С помощью API Distance Matrix вы можете указать расстояние и время в пути для матрицы пунктов отправления и назначения. Вы можете указать несколько вариантов, включая способ передвижения (автомобиль, велосипед, общественный транспорт или пешком), а также виды общественного транспорта (автобус, метро, ​​поезд, трамвай или железная дорога).

API Distance Matrix предоставляет информацию о рекомендуемом маршруте между начальной и конечной точками. Вы можете запросить следующие данные о расстоянии:

  • Расстояние для выбранного вида транспорта
  • Расстояние в километрах или милях
  • Расчетное время в пути в пробках

карта, показывающая пункты отправления и назначения на карте и в ответе API

Как работает API матрицы расстояний

API Distance Matrix использует любое количество исходных точек (начальных пунктов) и пунктов назначения и возвращает расстояние и время в пути между каждым исходным пунктом и всеми запрошенными пунктами назначения, начиная с первого исходного пункта в запросе и постепенно переходя к следующему.

Например, если в вашем запросе указаны A и B в качестве пунктов отправления, а C и D в качестве пунктов назначения, он вернет расстояния и время в пути в следующем порядке:

  • От А до С
  • От А до Д
  • Б в С
  • B в D

В следующем примере показан запрос для двух пунктов отправления: Вашингтон, округ Колумбия, и Бостон, с одним пунктом назначения — Нью-Йорк, штат Нью-Йорк, в формате JSON:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

Ресурсы

В следующей таблице приведены ресурсы, доступные через API Distance Matrix, а также возвращаемые им данные.

Ресурсы данных Данные возвращены Формат возврата
Матрица расстояний

Укажите пункты отправления и назначения в виде идентификаторов мест, адресов или координат широты/долготы.

  • Расстояние и время в пути между каждым пунктом отправления и каждым пунктом назначения
  • Продолжительность нахождения в пробке, если вы указали режим вождения и время отправления
  • JSON
  • XML

Как использовать API матрицы расстояний

1 Настройте Начните с настройки проекта Google Cloud и следуйте приведенным ниже инструкциям по настройке.
2 Попробуйте запрос матрицы расстояний Получив ключ API, вы сможете начать тестирование Distance Matrix API прямо из браузера. Примеры см. в разделе «Примеры запросов» в руководстве по началу работы .
3 Составьте более сложный запрос Попробуйте запрос, включающий несколько пунктов отправления и назначения. Узнайте о дополнительных параметрах для ограничения расчётов, таких как время отправления или ограничения маршрута. См. раздел «Дополнительные параметры» в руководстве по запросам и ответам Distance Matrix .
4 Понять основы реагирования Изучите ответы на запросы, чтобы подготовиться к использованию данных матрицы расстояний в вашем приложении. Подробнее см. в разделе «Ответы матрицы расстояний» .
5 Включите данные матрицы расстояний в свое приложение! Вы можете использовать эти данные для расчета расстояния и времени в пути.

Доступные клиентские библиотеки

Вызовите этот API на языке по вашему выбору через одну из следующих клиентских библиотек:

Клиенты Java, Python, Go и Node.js для сервисов Google Карт — это поддерживаемые сообществом клиентские библиотеки с открытым исходным кодом под лицензией Apache 2.0 . Загрузите их с GitHub, где также можно найти инструкции по установке и примеры кода.

Что дальше?