Directions API (Eski) demosu

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Bu demoda, bir konumdan diğerine arabayla yol tarifi almak için Directions API'yi (Eski) nasıl kullanacağınız gösterilmektedir. Bu demoyu ücretsiz olarak çalıştırabilirsiniz. Bu demoyu tek başına çalıştırmak aylık kotanızı aşmaz.

Başlamadan önce

Directions API'yi (eski) kullanmak için aşağıdaki gerekli kurulum adımlarını tamamlayın:

1. adım: Projenizi oluşturun

Konsol

  1. Google Cloud Console'daki proje seçici sayfasında, yeni bir Cloud projesi oluşturmaya başlamak için Proje Oluştur'u tıklayın.

    Proje seçici sayfasına gidin.

  2. Cloud projeniz için faturalandırmanın etkinleştirildiğinden emin olun. Projeniz için faturalandırmanın etkinleştirildiğini onaylayın.

    Google Cloud, ücretsiz deneme sürümü sunar. Deneme süresi, 90 günün sonunda veya hesapta 300 ABD doları tutarında ücret tahakkuk ettikten sonra (hangisi önce gerçekleşirse) sona erer. İstediğiniz zaman iptal edebilirsiniz. Daha fazla bilgi için Faturalandırma hesabı kredileri ve Faturalandırma başlıklı makaleleri inceleyin.

Google Cloud SDK

gcloud projects create "PROJECT"

Google Cloud SDK, Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

2. adım: API'leri veya SDK'ları etkinleştirin

Google Haritalar Platformu'nu kullanmak için projenizde kullanmayı planladığınız API'leri veya SDK'ları etkinleştirmeniz gerekir.

Konsol

Directions API'yi (Eski) etkinleştirme

Google Cloud SDK

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

Google Cloud SDK, Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

3. adım: API anahtarı alın

Bu adımda yalnızca API anahtarı oluşturma işlemi açıklanmaktadır. API anahtarınızı üretimde kullanıyorsanız API anahtarınızı kısıtlamanızı önemle tavsiye ederiz. Ürüne özel API anahtarlarını kullanma sayfasında daha fazla bilgi bulabilirsiniz.

API anahtarı, kullanım ve faturalandırma amacıyla projenizle ilişkili isteklerin kimliğini doğrulayan benzersiz bir tanımlayıcıdır. Projenizle ilişkili en az bir API anahtarınız olmalıdır. Yeni bir anahtar oluşturmak veya mevcut bir anahtara API ya da SDK eklemek için bu talimatları uygulayın.

Konsol

  1. Google Haritalar Platformu > Anahtarlar ve Kimlik Bilgileri sayfasına gidin.

    Anahtarlar ve Kimlik Bilgileri sayfasına gidin

  2. İstenirse projenizi seçin.

  3. Aşağıdakilerden birini yapın:

    • Yeni anahtar oluşturma:

      1. Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
      2. API anahtarı oluştur panelinde API kısıtlamalarını seçin listesini açın.
      3. Bu anahtarın ihtiyaç duymadığı API'leri temizleyin ve Directions API'nin seçili kaldığından emin olun.
      4. Oluştur'u tıklayın. Panelde yeni API anahtarınız gösterilir.

    • Mevcut bir anahtarı kullanma:

      1. Anahtarın adını tıklayın.
      2. API kısıtlamalarını seçin listesinde Directions API'yi seçin.
      3. Kaydet'i tıklayın.

    Burada bir API seçmek, API'yi etkinleştirmez. Directions API'nin API Kitaplığı sayfasında etkinleştirildiğinden emin olun.

  4. Anahtar dizesini daha sonra görmek için Anahtarlar ve Kimlik Bilgileri sayfasına gidip anahtar için Anahtarı göster'i tıklayın.

Konsol bu adımlardan farklı görünüyorsa Google Cloud belgelerindeki API anahtarı oluşturma ve API kısıtlamaları ekleme bölümlerine bakın.

Google Cloud SDK

Aşağıdaki komutlarda PROJECT_ID ifadesini proje kimliğinizle değiştirin.

  • Yeni anahtar oluşturma: Aşağıdaki komutu çalıştırın ve DISPLAY_NAME yerine anahtarın adını yazın. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=directions-backend.googleapis.com

    Google Cloud SDK, Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

  • Mevcut bir anahtarı kullanma: Aşağıdaki komutu çalıştırın ve KEY_ID değerini anahtarın kimliğiyle değiştirin. --append işareti, anahtarın halihazırda izin verdiği API'leri korur. Bu parametre kullanılmadığında komut, mevcut etiketleri değiştirir.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=directions-backend.googleapis.com

    Google Cloud SDK, Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

    Anahtar kimliği, anahtar dizesi veya görünen ad değildir. Bunu bulmak için gcloud services api-keys list --project="PROJECT_ID" komutunu çalıştırın. Kimlik, name alanının son kısmıdır: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Anahtar dizesini görmek için gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" komutunu çalıştırın.

Yol tarifleri alma

Disneyland'den Universal Studios, Hollywood'a arabayla yol tarifini JSON biçiminde almak için URL'yi web tarayıcınıza girin ve YOUR_API_KEY yerine API anahtarınızı yazın:

https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood&key=YOUR_API_KEY

Aşağıdaki JSON yanıtını alırsınız:

    {
       "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"
    }

Tebrikler! Directions API'yi (Eski) başarıyla ayarlayıp çağırarak yol tarifi aldınız.

Temizleme

Google Cloud projenizi silerek projede kullanılan tüm kaynaklar için faturalandırmayı durdurabilirsiniz.

  1. Google Cloud Console'da Kaynakları yönet sayfasına gidin:

    Kaynakları yönet sayfasına gidin

  2. Silmeyi planladığınız proje bir kuruluşa bağlıysa sayfanın üst kısmındaki kuruluş listesini seçip genişletin.
  3. Proje listesinde, silmek istediğiniz projeyi seçin ve Sil'i tıklayın.
  4. İletişim kutusunda proje kimliğini yazın ve projeyi silmek için Kapat'ı tıklayın.

Sonraki adımlar