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(по умолчанию) | Использует средние данные о трафике, не зависящие от времени, а не данные о трафике в реальном времени для расчета маршрута, что обеспечивает наименьшую задержку ответа. Эта настройка эквивалентна случаю, когда трафик не используется в API Directions и API Distance Matrix. |
TRAFFIC_AWARE(новый) | Оптимизированное по производительности качество живого трафика для снижения задержки. В отличие от TRAFFIC_AWARE_OPTIMAL , этот параметр применяет оптимизацию для значительного снижения задержки. Этот параметр также является новым для API маршрутов и не имеет эквивалента в API направлений или API матрицы расстояний. |
TRAFFIC_AWARE_OPTIMAL | Высококачественные, полные данные о дорожном движении. Эта настройка обеспечивает самую высокую задержку и эквивалентна настройке departure_time в Directions API и Distance Matrix API.Этот параметр эквивалентен режиму, используемому maps.google.com и мобильным приложением Google Maps. |
Сравнение расчета маршрута
В следующей таблице сравниваются параметры маршрутизации между API маршрутов и сервисами API направлений и API матрицы расстояний .
| Вариант трафика | API маршрутов | API маршрутов API матрицы расстояний | Задержка |
|---|---|---|---|
| Нет трафика в реальном времени | TRAFFIC_UNAWARE | свойство departure_time не установлено | Самая быстрая задержка из трех режимов. |
| Применяются условия реального трафика | TRAFFIC_AWARE | Нет эквивалента | Новый режим, добавленный API Routes. Он обеспечивает немного большую задержку, чем Задержка у него гораздо меньше, чем у |
| Применяются высококачественные, полные данные о трафике в реальном времени | 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. Некоторые пользователи API Distance Matrix решили проблему ограничений запроса, преобразовав точки широты/долготы в путевые точки полилинии.
Форматированные адреса (обратное геокодирование)
Routes API не предоставляет форматированные адреса в ответе. Чтобы получить форматированные адреса, используйте Geocoding API, который создан для этого варианта использования и обеспечивает более качественные результаты.
Доступные способы передвижения
Как и в случае с Directions API, Routes API использует DRIVE в качестве режима по умолчанию, когда запрос маршрута не указывает режим движения. Однако, когда запрос указывает режим движения для маршрута, Routes API не возвращает массив доступных режимов движения в качестве альтернативных вариантов для запроса. Если ваш вариант использования зависит от этой функции, отправьте запрос , описав, как вы используете функцию, чтобы мы могли принять меры.
XML как формат ответа
Routes API не предоставляет XML в качестве формата ответа. Вы можете найти ряд конвертеров JSON в XML в сети, которые должны подойти для ваших целей.