Зачем использовать API матрицы расстояний
Вы можете использовать API матрицы расстояний, чтобы определить наиболее эффективные маршруты передвижения между несколькими возможными пунктами отправления и назначения. Например, каких работников отправлять на рабочие места или с каких складов отправлять посылки.
Что вы можете сделать с помощью Distance Matrix 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 матрицы расстояний, а также данные, которые он возвращает.
Ресурсы данных | Данные возвращены | Формат возврата |
---|---|---|
Матрица расстояний Укажите места происхождения и назначения в виде идентификаторов мест, адресов или координат широты и долготы. |
|
|
Как использовать API матрицы расстояний
1 | Настройтесь. | Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке. |
2 | Попробуйте запрос матрицы расстояний | Получив ключ API, вы можете начать тестирование API Distance Matrix прямо из браузера. Примеры см. в разделе Примеры запросов в руководстве по началу работы . |
3 | Составьте более сложный запрос | Попробуйте запрос, в котором указаны несколько пунктов отправления и назначения. Узнайте о дополнительных параметрах для ограничения вычислений, таких как указанное время отправления или ограничения маршрута. См. Дополнительные параметры в руководстве по запросам и ответам Distance Matrix . |
4 | Понимать основы ответа | Изучите ответы данных, чтобы подготовиться к использованию данных матрицы расстояний для вашего приложения. Подробности см. в разделе «Ответы матрицы расстояний» . |
5 | Включите данные матрицы расстояний в свое собственное приложение! | Вы можете использовать эти данные для расчета расстояния и времени путешествия. |
Доступные клиентские библиотеки
Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:
- Java-клиент для сервисов Google Maps
- Клиент Python для служб Google Maps
- Клиент Go для сервисов Google Maps
- Клиент Node.js для сервисов Google Maps
Клиент Java, клиент Python, клиент Go и клиент Node.js для служб Google Maps — это клиентские библиотеки, поддерживаемые сообществом, с открытым исходным кодом по лицензии Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и пример кода.
Что дальше
- Начните использовать матрицу расстояний : перейдите к началу работы .
- Начните работу с примерами запросов и ответов : перейдите к запросу и ответу Distance Matrix.
- Следуйте рекомендациям : перейдите к разделу «Рекомендации по использованию веб-служб» .