Начало работы

Google Maps Distance Matrix API – это служба, которая предоставляет информацию о расстоянии и времени поездки для матрицы исходных точек и пунктов назначения, основанной на рекомендованном маршруте между начальной и конечной точками.

Эта служба также доступна как часть Google Maps JavaScript API на стороне клиента или для использования на стороне сервера с Java Client, Python Client, Go Client и Node.js Client for Google Maps Services.

Пример запроса и ответа

Доступ к Google Maps Distance Matrix API осуществляется с помощью интерфейса HTTP. Для этого используются запросы, состоящие из строки URL-адреса, включающей исходные точки и точки назначения, а также ключ API.

В следующем примере запрашиваются данные матрицы расстояний в формате JSON между Вашингтоном, округ Колумбия, и Нью-Йорком, штат Нью-Йорк:

https://maps.googleapis.com/maps/api/distancematrix/json?units=imperial&origins=Washington,DC&destinations=New+York+City,NY&key=YOUR_API_KEY

Попробуйте сделать это сами. Этот запрос можно проверить, введя URL-адрес в браузер (замените YOUR_API_KEY своим фактическим ключом API). Ответ включает расстояние и время в пути между указанными исходными точками и точками назначения.

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

Ниже приведен образец примера в формате JSON:

{
   "destination_addresses" : [ "New York, NY, USA" ],
   "origin_addresses" : [ "Washington, DC, USA" ],
   "rows" : [
      {
         "elements" : [
            {
               "distance" : {
                  "text" : "225 mi",
                  "value" : 361715
               },
               "duration" : {
                  "text" : "3 hours 49 mins",
                  "value" : 13725
               },
               "status" : "OK"
            }
         ]
      }
   ],
   "status" : "OK"
}

Начните кодирование с нашими клиентскими библиотеками

Клиентские библиотеки облегчают разработку с использованием интерфейсов API веб-служб Google Maps благодаря простой и эффективной реализации механизмов решения стандартных задач, например, аутентификации, блокировки запросов и автоматического повтора попыток. Интерфейс Google Maps Distance Matrix API доступен в Java Client, Python Client, Go Client и Node.js Client for Google Maps Services.

Аутентификация, квоты и политики

Активируйте API и получите ключ API

Чтобы использовать Google Maps Distance Matrix API, нужно предварительно активировать API в Google API Console и получить учетные данные для аутентификации. В каждом запросе нужно указывать ключ API (или идентификатор клиента, если вы используете премиум-план).

Нажмите кнопку ниже, чтобы выполнить следующие шаги процесса:

1. Создание или выбор проекта
2. Включение API
3. Получение ключа API

Получить ключ

Подробнее об учетных данных для аутентификации.

Квоты

На странице ограничений на использование можно найти подробную информацию о квотах, установленных для Google Maps Distance Matrix API.

Политики

Использование Google Maps Distance Matrix API должно соответствовать политикам API.

Подробнее

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