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

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

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

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

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

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

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

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

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

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

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

Например, если в вашем запросе указаны 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 Distance Matrix, а также возвращаемые им данные.

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

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

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

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

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

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

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

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

Что дальше?