В этой демонстрации показано, как использовать Directions API (Legacy), чтобы получить маршрут от одного местоположения до другого. Вы можете запустить эту демоверсию бесплатно. Если вы будете использовать только эту демоверсию, то не превысите месячную квоту.
Подготовка
Чтобы использовать Directions API (устаревшая версия), выполните следующие действия:
Шаг 1. Настройте проект
Консоль
-
Перейдите на страницу выбора проекта в консоли Google Cloud и нажмите Create Project (Создать проект).
-
Убедитесь, что для проекта Google Cloud включены платежные функции.
Мы предлагаем бесплатный пробный период для использования Google Cloud. Он длится 90 дней или пока сумма расходов не достигнет 300 долл. США в зависимости от того, что произойдет раньше. Отказаться от предложения можно в любое время. Ознакомьтесь с информацией о бонусах в платежных аккаунтах и об оплате.
Cloud SDK
gcloud projects create "PROJECT"
Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:
Шаг 2. Включите API или SDK
Для работы с платформой Google Карт вам потребуется включить API и SDK, которые будут использоваться в проекте.
Консоль
Cloud SDK
gcloud services enable \ --project "PROJECT" \ "directions-backend.googleapis.com"
Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:
3. Получите ключ API
На этом шаге рассматривается только создание ключа API. Если у вас есть собственный ключ API, мы настоятельно рекомендуем настроить для него ограничения. Подробная информация приводится в разделе Использование ключей API.
Ключ API – это уникальный идентификатор, который используется для аутентификации запросов, связанных с вашим проектом. Он нужен для учета использования API и оплаты. С вашим проектом должен быть связан хотя бы один ключ API.
Чтобы создать ключ API, выполните следующие действия.
Cloud Console
-
Откройте страницу Google Maps Platform > Credentials (Платформа Google Карт > Учетные данные).
-
На странице Credentials (Учетные данные) нажмите Create credentials > API key (Создать учетные данные > Ключ API).
Появится диалоговое окно с созданным ключом API. -
Нажмите Close (Закрыть).
Новый ключ API можно будет найти на странице Credentials (Учетные данные) в разделе API keys (Ключи API).
Не забудьте настроить ограничения для ключа API, прежде чем использовать его в рабочей среде.
Cloud SDK
gcloud services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:
Прокладывание маршрутов
Чтобы получить маршрут от Диснейленда до киностудии Universal Studios Hollywood в формате JSON, введите в браузере следующий URL, заменив YOUR_API_KEY своим ключом API:
https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood&key=YOUR_API_KEYВы должны получить следующий ответ JSON:
{ "geocoded_waypoints" : [ { "geocoder_status" : "OK", "place_id" : "ChIJRVY_etDX3IARGYLVpoq7f68", "types" : [ "bus_station", "transit_station", "point_of_interest", "establishment" ] }, { "geocoder_status" : "OK", "partial_match" : true, "place_id" : "ChIJp2Mn4E2-woARQS2FILlxUzk", "types" : [ "route" ] } ], "routes" : [ { "bounds" : { "northeast" : { "lat" : 34.1330949, "lng" : -117.9143879 }, "southwest" : { "lat" : 33.8068768, "lng" : -118.3527671 } }, "copyrights" : "Map data ©2016 Google", "legs" : [ { "distance" : { "text" : "35.9 mi", "value" : 57824 }, "duration" : { "text" : "51 mins", "value" : 3062 }, "end_address" : "Universal Studios Blvd, Los Angeles, CA 90068, USA", "end_location" : { "lat" : 34.1330949, "lng" : -118.3524442 }, "start_address" : "Disneyland (Harbor Blvd.), S Harbor Blvd, Anaheim, CA 92802, USA", "start_location" : { "lat" : 33.8098177, "lng" : -117.9154353 }, ... Additional results shortened in this example[] ... "overview_polyline" : { "points" : "knjmEnjunUbKCfEA?_@]@kMBeE@qIIoF@wH@eFFk@WOUI_@?u@j@k@`@EXLTZHh@Y`AgApAaCrCUd@cDpDuAtAoApA{YlZiBdBaIhGkFrDeCtBuFxFmIdJmOjPaChDeBlDiAdD}ApGcDxU}@hEmAxD}[tt@yNb\\yBdEqFnJqB~DeFxMgK~VsMr[uKzVoCxEsEtG}BzCkHhKWh@]t@{AxEcClLkCjLi@`CwBfHaEzJuBdEyEhIaBnCiF|K_Oz\\ {MdZwAbDaKbUiB|CgCnDkDbEiE|FqBlDsLdXqQra@kX|m@aF|KcHtLm@pAaE~JcTxh@w\\`v@gQv`@}F`MqK`PeGzIyGfJiG~GeLhLgIpIcE~FsDrHcFfLqDzH{CxEwAbBgC|B}F|DiQzKsbBdeA{k@~\\oc@bWoKjGaEzCoEzEwDxFsUh^wJfOySx[uBnCgCbCoFlDmDvAiCr@eRzDuNxC_EvAiFpCaC|AqGpEwHzFoQnQoTrTqBlCyDnGmCfEmDpDyGzGsIzHuZzYwBpBsC`CqBlAsBbAqCxAoBrAqDdDcNfMgHbHiPtReBtCkD|GqAhBwBzBsG~FoAhAaCbDeBvD_BlEyM``@uBvKiA~DmAlCkA|B}@lBcChHoJnXcB`GoAnIS~CIjFDd]A|QMlD{@jH[vAk@`CoGxRgPzf@aBbHoB~HeMx^eDtJ}BnG{DhJU`@mBzCoCjDaAx@mAnAgCnBmAp@uAj@{Cr@wBPkB@kBSsEW{GV}BEeCWyAWwHs@qH? cIHkDXuDn@mCt@mE`BsH|CyAp@}AdAaAtAy@lBg@pCa@jE]fEcBhRq@pJKlCk@hLFrB@lD_@xCeA`DoBxDaHvM_FzImDzFeCpDeC|CkExDiJrHcBtAkDpDwObVuCpFeCdHoIl\\uBjIuClJsEvMyDbMqAhEoDlJ{C|J}FlZuBfLyDlXwB~QkArG_AnDiAxC{G|OgEdLaE`LkBbEwG~KgHnLoEjGgDxCaC`BuJdFkFtCgCnBuClD_HdMqEzHcBpB_C|BuEzCmPlIuE|B_EtDeBhCgAdCw@rCi@|DSfECrCAdCS~Di@jDYhA_AlC{AxCcL`U{GvM_DjFkBzBsB`BqDhBaEfAsTvEmEr@iCr@qDrAiFnCcEzCaE~D_@JmFdGQDwBvCeErEoD|BcFjC}DbEuD~D`@Zr@h@?d@Wr@}@vAgCbEaHfMqA`Cy@dAg@bAO`@gCi@w@W" }, "summary" : "I-5 N and US-101 N", "warnings" : [], "waypoint_order" : [] } ], "status" : "OK" }
Поздравляем! Вы успешно настроили и вызвали Directions API (устаревшая версия), чтобы получить маршруты.
Очистка
Вы можете удалить проект Google Cloud, чтобы прекратить оплату всех ресурсов, используемых в нем.
- В консоли Google Cloud перейдите на страницу Управление ресурсами.
- Если проект, который вы хотите удалить, связан с организацией, выберите и разверните список организаций в верхней части страницы.
- В списке проектов выберите проект, который нужно удалить, и нажмите Удалить.
- В диалоговом окне введите идентификатор проекта и нажмите Shut down (Отключить), чтобы удалить проект.
Дальнейшие действия
Чтобы начать разработку с использованием Directions API (устаревшая версия), настройте проект Google Cloud:
Полный список параметров для создания HTTP-запроса Directions API (Legacy):
Узнайте, как писать код с помощью наших клиентских библиотек, которые обеспечивают простую нативную реализацию распространенных задач, таких как аутентификация, регулирование запросов и автоматический повтор. Directions API (устаревшая версия) доступен в клиентах Java, Python, Go и Node.js для сервисов Google Карт.