Routes API обеспечивает улучшенную производительность при расчёте маршрутов, расстояния и времени в пути, что делает его выгодным для замены приложений, использующих Directions API и Distance Matrix API. Большая часть функций Routes API обратно совместима как с Directions API, так и с Distance Matrix API.
Используйте это руководство, чтобы понять ключевые различия между Routes API и продуктами, которые он заменяет, а также узнать, как вносить необходимые изменения. Подробнее о других функциях Routes API см. в обзоре продукта .
Ключевые улучшения
В этом разделе рассматриваются некоторые улучшения, которые вы можете ожидать при использовании Routes API в своих приложениях.
Увеличенные лимиты запросов
| API маршрутов вычисляет матрицу маршрутов |
|
| API матрицы расстояний |
|
Более быстрые ответы на запросы
Функция Compute Route Matrix обеспечивает следующие улучшения задержки:
- Получать потоковые элементы ответа до того, как будет рассчитана вся матрица.
- Используйте маски полей для настройки деталей ответа , запрашивая только те данные, которые вам нужны. Это передовой опыт, который также помогает сократить ваши расходы.
- Улучшенные расчеты маршрутов для трафика , позволяющие найти компромисс между качеством данных и временем отклика.
Улучшения маршрутизации
Функция вычисления маршрута предлагает следующие улучшения маршрутизации:
- Информация о платных дорогах , а также расстояние и расчетное время прибытия.
- Маршруты для двухколесных транспортных средств .
- Оцените безопасность промежуточных остановок .
- Повышена точность определения времени прибытия за счет установки направления движения и стороны дороги для путевых точек.
Запрашивайте только те данные, которые вам нужны
Теперь вы можете указать, какие поля следует возвращать, что сокращает время обработки и расходы на выставление счетов.
| API маршрутов Вычислить маршруты Вычислить матрицу маршрута | В ваших запросах необходимо использовать маску полей, чтобы указать, какие поля вы хотите вернуть в ответе. Маскировка полей гарантирует, что вы не запросите ненужные данные, что позволяет избежать ненужного времени обработки и дополнительных расходов. Более подробную информацию см. в разделе Выбор полей для возврата . |
| API маршрутов API матрицы расстояний | Возвращает список полей по умолчанию, даже если они не требуются вашему приложению. Это может привести к ненужному времени обработки и дополнительным расходам. |
Улучшенные расчеты маршрутов для трафика
API маршрутов поддерживает три параметра маршрутизации, которые можно использовать для баланса между задержкой ответа и качеством данных при запросе информации о дорожном движении.
Для получения дополнительной информации см. раздел Настройка качества и задержки .
TRAFFIC_UNAWARE(по умолчанию) | Для расчета маршрута используются усредненные, не зависящие от времени, а не актуальные данные о дорожном движении, что обеспечивает минимальную задержку ответа. Этот параметр эквивалентен случаю, когда данные о дорожном движении не используются в Directions API и Distance Matrix API. |
TRAFFIC_AWARE(новый) | Оптимизированное для производительности качество трафика в реальном времени для сокращения задержек. В отличие от TRAFFIC_AWARE_OPTIMAL , этот параметр применяет оптимизацию для значительного сокращения задержек. Этот параметр также является новым для Routes API и не имеет аналогов в Directions API или Distance Matrix API. |
TRAFFIC_AWARE_OPTIMAL | Высококачественные и полные данные о дорожном движении. Этот параметр обеспечивает максимальную задержку и эквивалентен параметру departure_time в Directions API и Distance Matrix API.Этот параметр эквивалентен режиму, используемому maps.google.com и мобильным приложением Google Maps. |
Сравнение расчета маршрута
В следующей таблице сравниваются варианты маршрутизации между службами Routes API и Directions API и Distance Matrix API .
| Вариант движения | API маршрутов | API маршрутов API матрицы расстояний | Задержка |
|---|---|---|---|
| Нет трафика в реальном времени | TRAFFIC_UNAWARE | свойство departure_time не установлено | Самая низкая задержка из трех режимов. |
| Применяются условия реального дорожного движения | TRAFFIC_AWARE | Нет эквивалента | Новый режим, добавленный Routes API. Он обеспечивает чуть большую задержку, чем Задержка у него гораздо меньше, чем у |
| Применяются высококачественные, полные данные о дорожном движении в реальном времени | TRAFFIC_AWARE_OPTIMAL | набор свойств departure_time | Эквивалентно режиму, используемому maps.google.com и мобильным приложением Google Maps. Для Compute Route Matrix количество элементов в запросе (количество пунктов отправления × количество пунктов назначения) не может превышать 100. |
Ключевые отличия
В этом разделе рассматриваются основные различия между Routes API и заменяемыми им сервисами, а также способы устранения этих различий при миграции с этих сервисов в существующих приложениях.
Вызовите одну службу вместо двух
| API маршрутов | Включите только одну службу в консоли API, чтобы ваше приложение использовало Compute Routes и Compute Route Matrix. Более подробную информацию см. в разделе Настройка в консоли API Google . |
| API маршрутов API матрицы расстояний | Включите две службы: Directions API и Distance Matrix API как отдельные службы в консоли API. |
Использует HTTPS POST запросы
| API маршрутов | Передайте параметры в теле запроса или в заголовках как часть HTTP POST .Примеры см.: - Рассчитать маршрут - Вычислить матрицу маршрута |
| API маршрутов API матрицы расстояний | Передача параметров URL с помощью HTTP GET . |
Различия в ответах ETA
Routes API возвращает расчетное время прибытия и использует свойство ответа duration иначе, чем службы Directions API и Distance Matrix API, как показано в таблице ниже.
| Тип расчетного времени прибытия | API маршрутов | API маршрутов API матрицы расстояний |
|---|---|---|
| Не учитывает дорожную ситуацию, расчетное время прибытия не зависит от времени. | Установить с помощью
| Соответствует тому, что в запросе не указано
|
| Расчетное время прибытия с учетом дорожной ситуации в реальном времени. | Устанавливается с помощью
| Устанавливается с помощью
|
Полилинейные путевые точки
Вам больше не нужно преобразовывать координаты широты/долготы в путевые точки полилиний с помощью этого сервиса, который поддерживает тело запроса POST и, следовательно, не подвержен ограничениям на длину строки URL. Некоторые пользователи Distance Matrix API решили проблему ограничений запроса, преобразовав точки широты/долготы в путевые точки полилиний.
Форматированные адреса (обратное геокодирование)
API маршрутов не предоставляет форматированные адреса в ответе. Для получения форматированных адресов используйте API геокодирования, разработанный специально для этого случая и обеспечивающий более качественные результаты.
Доступные способы передвижения
Как и в случае с Directions API, Routes API использует режим DRIVE в качестве режима по умолчанию, когда в запросе маршрута не указан способ передвижения. Однако, когда в запросе указан способ передвижения, Routes API не возвращает массив доступных способов передвижения в качестве альтернативных вариантов. Если ваш вариант использования зависит от этой функции, сообщите нам о проблеме, описав, как вы её используете, чтобы мы могли разобраться с ней.
XML как формат ответа
API маршрутов не поддерживает XML в качестве формата ответа. В интернете можно найти множество конвертеров JSON в XML, которые подойдут для ваших целей.