Обзор Distance Matrix API (устаревшая версия)

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

Введение

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

Зачем использовать Distance Matrix API (Legacy)

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

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

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

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

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

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

Как работает Distance Matrix API (устаревшая версия)

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

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

  • A–C
  • A–D
  • B2C
  • 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

Ресурсы

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

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

Укажите начальные и конечные точки в виде идентификаторов мест, адресов или координат широты и долготы.

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

Как использовать Distance Matrix API (устаревшая версия)

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

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

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

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

Дальнейшие действия