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

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

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

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

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

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

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 Distance Matrix прямо из браузера. Примеры см. в разделе Примеры запросов в руководстве по началу работы .
3 Составьте более сложный запрос Попробуйте запрос, в котором указаны несколько пунктов отправления и назначения. Узнайте о дополнительных параметрах для ограничения вычислений, таких как указанное время отправления или ограничения маршрута. См. Дополнительные параметры в руководстве по запросам и ответам Distance Matrix .
4 Понимать основы ответа Изучите ответы данных, чтобы подготовиться к использованию данных матрицы расстояний для вашего приложения. Подробности см. в разделе «Ответы матрицы расстояний» .
5 Включите данные матрицы расстояний в свое собственное приложение! Вы можете использовать эти данные для расчета расстояния и времени путешествия.

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

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

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

Что дальше