Navigation Connect'i ayarlama

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

Bu belgede, Navigation Connect'i kullanmaya başlamak için uygulamanız gereken adımlar açıklanmaktadır.

Ön koşullar

Bu kılavuzda, Google Cloud Hesabınızı ve faturalandırmanın etkin olduğu Google Cloud projenizi nasıl oluşturacağınız gösterilmektedir. Navigation Connect API'yi kullanırken nasıl ücretlendirildiğinizi de bilmeniz gerekir.

  1. Navigation Connect Kullanımı ve Faturalandırması'nda kullanım için faturalandırmayı ve maliyeti inceleyin.
  2. Google Cloud Hesabınız olduğunu doğrulayın.

    Google Cloud Console'da oturum açın
  3. Faturalandırmanın etkin olduğu bir Google Cloud projeniz olduğunu doğrulayın.

    Faturalandırma sayfasına gidin
    1. Faturalandırma sayfasını açmak için projenizi seçin.
    2. Faturalandırma sayfasında:

      • Seçilen proje için faturalandırma zaten etkinleştirilmişse ve yalnızca tek bir faturalandırma hesabınız varsa Faturalandırma sayfası açılır.
      • Birden fazla faturalandırma hesabınız varsa projeyle ilişkili faturalandırma hesabı hakkındaki ayrıntıları görmek için Bağlı faturalandırma hesabına git'i seçin.
      • Bir faturalandırma hesabı varsa ancak projeyle ilişkilendirilmemişse projeye bir faturalandırma hesabı bağlamanız istenir.
      • Faturalandırma hesabı yoksa veya yeni bir faturalandırma hesabı oluşturmak istiyorsanız yeni bir faturalandırma hesabı oluşturmak için Faturalandırma Hesaplarını Yönet'i seçin. Daha fazla bilgi için Yeni bir self servis Cloud Faturalandırma Hesabı oluşturma başlıklı makaleyi inceleyin.

API'yi etkinleştirme ve uygulamanızı doğrulama

Bu kılavuzda, Navigation Connect API'yi etkinleştirme ve uygulamanızı Google Cloud Console'da doğrulama süreci açıklanmaktadır. Bu sayede uygulamanız, Google Haritalar ve Waze ile güvenli bir şekilde arayüz oluşturabilir. Navigation Connect API'yi kullanmak için bu işlemi tamamlamanız gerekir.

1. Navigation Connect API'yi etkinleştirme

Google Cloud projenizde Navigation Connect API'yi etkinleştirmek için Google Cloud Console'u veya gcloud komutunu kullanın.

API'yi etkinleştirmek için aşağıdaki adımları uygulayın:

Konsol

  1. Google Cloud Console'da ürün sayfasını açın:

    Navigation Connect API'yi etkinleştirme
  2. Etkinleştir düğmesini tıklayın.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "navigationconnect.googleapis.com"

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

2. Uygulama doğrulama sürecini başlatma

API'yi etkinleştirdikten sonra Navigation Connect API'yi etkinleştirmek için uygulamanızı doğrulamanız gerekir. Yalnızca API'yi etkinleştirmek erişim izni vermez. Navigation Connect API'yi kullanabilmek için işletme ve uygulama ayrıntılarını incelemeye göndermeniz gerekir.

Doğrulama sürecini başlatmak için aşağıdaki yöntemlerden birini kullanın:

  • API Marketplace:
    1. API Marketplace'te Navigation Connect API kartını bulun.
    2. Doğrulama sürecini başlatmak için mavi Doğrulama gerekli simgesini tıklayın.
  • Google Cloud Console'da Anahtarlar ve Kimlik Bilgileri:
    1. Google Cloud Console'da Anahtarlar ve Kimlik Bilgileri sayfasına gidin.
    2. Navigation Connect Keys and Credentials'ı (Navigation Connect Anahtarları ve Kimlik Bilgileri) tıklayın.
    3. Banner'da Doğrulamayı başlat'ı tıklayın.

3. Uygulama, veri toplama ve gizlilik ayrıntılarını sağlama

Aşağıdaki tabloda, uygulama doğrulama için sağlamanız gereken bilgiler açıklanmaktadır:

Alan Açıklama
Uygulama ayrıntıları

Uygulamanızın Google Haritalar ve Waze'de doğru şekilde gösterilmesi için aşağıdaki bilgileri sağlayın.

İşletme veya uygulama adı Google Haritalar ve Waze'de kullanıcılara gösterilecek adı girin.
Uygulama tanımlayıcısı Android paket adınızı veya iOS paket kimliğinizi girin.
iOS geçiş bağlantısı Kullanıcıların uygulamanıza dönmesine olanak tanıyan iOS geçiş bağlantısını sağlayın (yalnızca Waze'de kullanılabilir).
Uygulama logosu (yalnızca Waze) (İsteğe bağlı) Navigasyon oturumu sırasında uygulamanızın logosunu Waze'de göstermek için PNG veya JPG biçiminde bir logo (32x32 ila 128x128 piksel) yükleyin.
Veri toplama ve gizlilikle ilgili ayrıntılar

Şeffaflık, sürücü güveni ve veri güvenliği sağlamak için aşağıdaki bilgileri girin.

Gizlilik politikası bağlantısı Uygulamanızın gizlilik politikasının URL'sini girin. Bu bağlantı, kullanıcı rızası ekranında görünür.
Ek veri denetleyiciler (isteğe bağlı) ISV gibi üçüncü taraf veri yöneticilerinin ticari unvanını ve gizlilik politikası bağlantısını sağlayın. Bu bilgiler kullanıcı rızası ekranında gösterilir.
Veri uygunluğu Uygulamanız ABD'de faaliyet gösteriyorsa yerel düzenlemelere uygunluğu sağlamak için Bu uygulama ABD'de gerçekleşen yolculuklar için kullanılacak onay kutusunu işaretleyin.

4. İncele ve gönder

Uygulamanızı doğrulama için göndermeden önce sağladığınız bilgilerin özetini inceleyin.

  1. Uygulama adınızı, platformunuzu, kimliklerinizi ve bağlantılarınızı dikkatlice inceleyin.

  2. Tüm bilgiler doğru onay kutusunu işaretleyin.
  3. Gönder'i tıklayın.

Uygulamanızı doğrulama için gönderdikten sonra inceleme aşaması başlar.

  • Zaman çizelgesi: Doğrulama genellikle 1-3 iş günü sürer.
  • Bildirim: Doğrulama durumu değiştiğinde bir e-posta alırsınız. Ayrıca, ödeme profili kimliğinizi veya Android geliştirici kimliğinizi isteyen bir e-posta da alırsınız. Android geliştirici kimliğine ihtiyacınız varsa Geliştirici hesabı oluşturma başlıklı makaleyi inceleyin.
  • Durum takibi: Google Cloud Console'daki Anahtarlar ve Kimlik Bilgileri sayfasından ilerleme durumunuzu takip edin.
  • Destek: Onaydan sonra yapılandırmanızı üretimi etkilemeden güncellemek için destek kaydı oluşturun.

Doğrulama tamamlandıktan sonra uygulamanız, Navigation Connect API'yi kullanarak navigasyon oturumuna erişim yetkisi veren ve Google Haritalar ile Waze'den gezi ayrıntılarını almanızı sağlayan gezi jetonları oluşturma yetkisi alır.

Google Haritalar Platformu ürünleri, yetkisiz kullanımı önlemek için API çağrılarının bir OAuth jetonu içermesini gerektirir.

OAuth jetonu oluşturma

Navigation Connect, kimlik doğrulama için OAuth 2.0'ı destekler. Google, web sunucusu senaryoları gibi yaygın OAuth 2.0 senaryolarını destekler.

Bu dokümanda, geliştirme ortamınızda bir Navigation Connect çağrısına OAuth jetonunun nasıl iletileceği açıklanmaktadır. OAuth'u üretim ortamında kullanma hakkında daha fazla bilgi için Google'da kimlik doğrulama yöntemleri başlıklı makaleyi inceleyin.

Sunucuya API istekleri göndererek Google Maps API'leri doğrudan çağırabilir veya kodunuzu basitleştirmek için istemci kitaplıklarını kullanabilirsiniz. Google Haritalar; Go, Java, Node.js ve Python için istemci kitaplıkları sağlar. Daha fazla bilgi için Navigation Connect istemci kitaplıkları başlıklı makaleyi inceleyin.

OAuth'a genel bakış

Dağıtım ortamınıza bağlı olarak OAuth ile erişim jetonlarını çeşitli şekillerde oluşturabilir ve yönetebilirsiniz.

Uygulamanız ile bir Google hizmeti arasındaki sunucudan sunucuya etkileşimler için OAuth 2.0'ı kullanabilirsiniz. Bu senaryoda, bireysel bir kullanıcı yerine uygulamanızla ilişkili bir hizmet hesabı kullanırsınız. Kullanıcıları doğrudan dahil etmeden hizmet hesabını kullanarak API istekleri gönderebilirsiniz. Kimlik doğrulama yöntemleri hakkında daha fazla bilgi için Google'da kimlik doğrulama yöntemleri başlıklı makaleyi inceleyin.

Alternatif olarak, Navigation Connect'i bir Android veya iOS mobil uygulamasına entegre edebilirsiniz. Farklı dağıtım ortamları için OAuth kullanımı ve erişim jetonlarını yönetme hakkında daha fazla bilgi edinmek üzere Google API'lerine Erişmek için OAuth 2.0'ı Kullanma başlıklı makaleyi inceleyin.

OAuth kapsamları

Navigation Connect ile OAuth kullanmak için OAuth jetonuna aşağıdaki kapsamı atamanız gerekir:

https://www.googleapis.com/auth/cloud-platform

Örnek: Yerel geliştirme ortamınızda REST API çağrılarını deneme

Jeton oluşturan bir ortamınız yoksa ve Navigation Connect'i OAuth jetonuyla denemek istiyorsanız bu bölümdeki prosedürü uygulayın.

Bu örnekte, çağrıyı yapmak için Uygulama Varsayılan Kimlik Bilgileri (ADC) tarafından sağlanan OAuth jetonunun nasıl kullanılacağı açıklanmaktadır. İstemci kitaplıklarıyla Google API'lerini çağırmak için ADC'yi kullanma hakkında daha fazla bilgi edinmek istiyorsanız İstemci kitaplıklarını kullanarak kimlik doğrulama başlıklı makaleyi inceleyin.

Aşağıdaki REST prosedürünü yalnızca geliştirme veya test için kullanın, üretim için kullanmayın.

Ön koşullar

ADC kullanarak REST isteği göndermeden önce ADC'ye kimlik bilgileri sağlamak için gcloud CLI'yı kullanın:

  1. gcloud KSA'yı yükleyip ilk kullanıma hazırlayın. Daha fazla bilgi için gcloud CLI'yi yükleme başlıklı makaleyi inceleyin.

  2. gcloud CLI ile kimlik doğrulama:

    gcloud auth application-default login
  3. Kimlik bilgilerinizi ADC tarafından kullanılan yerel kimlik bilgisi dosyasına kaydetmek için oturum açma işlemini tamamlayın.

Daha fazla bilgi için Yerel geliştirme ortamı için ADC'yi ayarlama başlıklı makaleyi inceleyin.

REST isteği gönderme

Bu örnekte iki istek başlığı iletilir:

  • Jetonu oluşturmak için aşağıdaki komutu kullanarak OAuth jetonunu Authorization başlığında iletin:

    gcloud auth application-default print-access-token

    Döndürülen jetonun kapsamı https://www.googleapis.com/auth/cloud-platform.

  • X-Goog-User-Project başlığında, faturalandırmanın etkin olduğu Google Cloud projenizin kimliğini veya adını iletin.

Navigation Connect'i OAuth jetonu kullanarak çağırmak için aşağıdaki adımları uygulayın:

  1. Aşağıdaki kod örneğinde yer tutucuları kendi değerlerinizle değiştirin:

    • PROJECT_ID: Google Cloud proje kimliğiniz
    • ANDROID_APP_ID: Varsa uygulamanızın Android paket adı
    • IOS_APP_ID: Varsa uygulamanızın iOS paket kimliği
    #!/bin/bash
    trip_id="$(uuidgen)"
    access_token="$(gcloud auth application-default print-access-token)"
    curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
    -H "Authorization: Bearer ${access_token}" \
    -H "Content-Type: application/json" \
    -d '{
    "androidAppId": "ANDROID_APP_ID",
    "iosAppId": "IOS_APP_ID",
    }'
  2. curl komutunu kopyalamak için kod örneğinde Kopyala'yı tıklayın.

  3. Komutu bir terminal penceresine yapıştırıp çalıştırın.

Yanıt bir JSON nesnesi olur:

{
  "name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
  "authToken": {
    "token": "BASE64_ENCODED_TRIP_TOKEN",
    "expireTime": "2026-03-06T11:09:47.476942Z"
  },
  "state": "NEW",
  "execution": {
    "traveledDistanceMeters": 0,
    "stopAddedInRoute": false
  },
  "createTime": "2026-03-05T23:09:50.768959Z",
  "updateTime": "2026-03-05T23:09:50.768959Z",
}

Bu yanıt aşağıdaki değerleri içerir:

  • PROJECT_NUMBER: Projenin benzersiz uzun tam sayı tanımlayıcısı
  • TRIP_ID: Arka ucunuzun oluşturduğu UUIDv4 gezi kimliği
  • BASE64_ENCODED_TRIP_TOKEN: Google Haritalar veya Waze'de takip edilen adım adım rotayı başlatmak için createTrip yönteminin döndürdüğü kimliği doğrulanmış jeton

Sorun giderme

İsteğiniz, bu API'nin son kullanıcı kimlik bilgilerini desteklemediğini belirten bir hata mesajı döndürürse ADC kurulumunuzla ilgili sorunları giderme başlıklı makaleyi inceleyin.

Sırada ne var?

Ardından, Navigation Connect API için hizmet hesaplarınızı yapılandırarak arka uç altyapınız, Google Haritalar ve Waze arasında güvenli, sunucudan sunucuya iletişimi destekleyin.

Hizmet hesabınızı oluşturma