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

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

Введение

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

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

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

Что можно сделать с помощью API матрицы расстояний

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

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

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

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

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

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

Например, если в вашем запросе указаны пункты отправления A и B, а пункты назначения C и 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 матрицы расстояний, а также возвращаемых им данных.

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

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

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

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

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

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

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

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

Что дальше?