Демонстрация API маршрутов

Разработчики из Европейской экономической зоны (ЕЭЗ)

Эта демонстрация показывает, как использовать API Directions для получения набора маршрутов движения из одного места в другое. Вы можете запустить эту демонстрацию бесплатно. Запуск только этой демонстрации не превышает вашу ежемесячную квоту .

Для использования API построения маршрутов выполните необходимые шаги настройки, перейдя по следующим вкладкам:

Шаг 1

Консоль

  1. В консоли Google Cloud на странице выбора проекта нажмите «Создать проект» , чтобы начать создание нового проекта Cloud.

    Перейдите на страницу выбора проекта.

  2. Убедитесь, что для вашего облачного проекта включена функция выставления счетов. Подтвердите, что выставление счетов включено для вашего проекта .

    Google Cloud предлагает пробный период с нулевой комиссией. Пробный период истекает по истечении 90 дней или после того, как на счету накопится сумма расходов в размере 300 долларов США, в зависимости от того, что наступит раньше. Отменить можно в любое время. Для получения дополнительной информации см. разделы «Бонусы на счете» и «Выставление счетов».

Облачный SDK 

gcloud projects create "PROJECT"

Подробнее о Google Cloud SDK , установке Cloud SDK и следующих командах можно узнать здесь:

Шаг 2

Для использования платформы Google Maps необходимо включить API или SDK, которые вы планируете использовать в своем проекте.

Консоль

Включите API для построения маршрутов.

Облачный SDK 

gcloud services enable \
    --project "PROJECT" \
    "directions-backend.googleapis.com"

Подробнее о Google Cloud SDK , установке Cloud SDK и следующих командах можно узнать здесь:

Шаг 3

На этом этапе выполняется только создание ключа API. Если вы используете свой ключ API в рабочей среде, мы настоятельно рекомендуем ограничить его использование. Более подробную информацию можно найти на странице «Использование ключей API» для конкретного продукта.

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

Для создания ключа API:

Консоль

  1. Перейдите на страницу «Платформа Google Maps» > «Учетные данные» .

    Перейдите на страницу «Учетные данные».

  2. На странице «Учетные данные» нажмите «Создать учетные данные» > «Ключ API» .
    В диалоговом окне « Создан ключ API» отображается ваш недавно созданный ключ API.
  3. Нажмите «Закрыть».
    Новый ключ API указан на странице «Учетные данные» в разделе «Ключи API» .
    (Не забудьте ограничить использование ключа API перед его применением в рабочей среде.)

Облачный SDK 

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Подробнее о Google Cloud SDK , установке Cloud SDK и следующих командах можно узнать здесь:

Как добраться

Чтобы получить маршрут проезда от Диснейленда до Universal Studios (Голливуд) в формате 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"
    }

Поздравляем! Вы успешно настроили и подключили API Directions для получения маршрута.

Уборка

Вы можете удалить свой проект Google Cloud, чтобы прекратить выставление счетов за все ресурсы, используемые в этом проекте.

  1. В консоли Google Cloud перейдите на страницу «Управление ресурсами» :

    Перейдите на страницу «Управление ресурсами».

  2. Если проект, который вы планируете удалить, привязан к организации, выберите и разверните список организаций в верхней части страницы.
  3. В списке проектов выберите проект, который хотите удалить, и нажмите «Удалить» .
  4. В диалоговом окне введите идентификатор проекта и нажмите «Завершить» , чтобы удалить проект.

Следующие шаги

  • Начните разработку с использованием Directions API, настроив свой проект в Google Cloud:

    Настройка в облачной консоли

  • Список всех параметров, используемых при формировании HTTP-запроса к Directions API, можно найти здесь:

    Как добраться

  • Научитесь программировать с помощью наших клиентских библиотек, которые предоставляют простые, нативные реализации распространенных задач, таких как аутентификация, ограничение запросов и автоматическое повторение попыток. API Directions (устаревшая версия) доступен в Java-клиенте, Python-клиенте, Go-клиенте и Node.js-клиенте для сервисов Google Maps .