Geocoding API'yi ayarlama

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Fatura adresiniz Avrupa Ekonomik Alanı'ndaysa 8 Temmuz 2025'ten itibaren Hizmetler'i kullanımınızda Google Haritalar Platformu AEA Hizmet Şartları geçerli olacaktır. İşlevler bölgeye göre değişir. Daha fazla bilgi edinin.

Bu belgede, Geocoding API'yi kullanmaya başlamak için gereken adımlar açıklanmaktadır.

1. Hesap ve faturalandırma Ön koşulları karşıladığınızdan emin olun.

2. API'yi etkinleştirme Google Cloud projenizde API'yi etkinleştirin.

3. İlk isteğinizi gönderme Kimliği doğrulanmış bir API isteği göndermek için API anahtarı veya OAuth'u yapılandırın.

Önemli Bilgi: Bu kurulum kılavuzu hem API anahtarı yapılandırma hem de OAuth jetonu oluşturma prosedürünü içerir. Dağıtım ortamınız için geçerli olan prosedürü seçin.

Google Haritalar Platformu ürünleri, API çağrılarının API anahtarı veya OAuth jetonu içermesini zorunlu kılarak yetkisiz kullanıma karşı korunur.

API anahtarı OAuth jetonu

OAuth jetonu oluşturma

Geocoding API, kimlik doğrulama için OAuth 2.0 kullanımını destekler. Google, web sunucusu gibi yaygın OAuth 2.0 senaryolarını destekler.

Bu belgede, geliştirme ortamınızda Coğrafi Kodlama API'si çağrısına OAuth jetonunun nasıl iletileceği açıklanmaktadır. OAuth'u üretim ortamında kullanmayla ilgili talimatlar için Google'daki kimlik doğrulama yöntemleri başlıklı makaleyi inceleyin.

Not:

Google Haritalar API'lerini doğrudan sunucuya API istekleri göndererek kullanabilirsiniz. Ancak istemci kitaplıkları, yazmanız gereken kod miktarını önemli ölçüde azaltan basitleştirmeler sağlar. Google Haritalar, Go, Java, Node.js ve Python gibi birçok programlama dili için istemci kitaplıkları sağlar.

Belgeler ve örnekler için Geocoding API İstemci Kitaplıkları'na bakın.

OAuth hakkında

Dağıtım ortamınıza bağlı olarak OAuth ile erişim jetonları oluşturmanın ve yönetmenin birçok yolu vardır.

Örneğin, Google OAuth 2.0 sistemi, uygulamanız ile bir Google hizmeti arasındaki etkileşimler gibi sunucudan sunucuya etkileşimleri destekler. Bu senaryo için bir hizmet hesabına ihtiyacınız vardır. Hizmet hesabı, bireysel bir son kullanıcıya değil, uygulamanıza ait olan bir hesaptır. Uygulamanız, hizmet hesabı adına Google API'lerini çağırır. Dolayısıyla kullanıcılar doğrudan dahil olmaz. Kimlik doğrulama yöntemleri hakkında daha fazla bilgi için Google'daki kimlik doğrulama yöntemleri başlıklı makaleyi inceleyin.

Alternatif olarak, Coğrafi Kodlama API'sini Android veya iOS mobil uygulamasının bir parçası olarak da kullanabilirsiniz. Farklı dağıtım ortamları için erişim jetonlarını yönetme bilgileri de dahil olmak üzere Coğrafi Kodlama API'si ile OAuth kullanma hakkında genel bilgi için Google API'lerine erişmek için OAuth 2.0'ı kullanma başlıklı makaleyi inceleyin.

OAuth kapsamları hakkında

OAuth'u Coğrafi Kodlama API'si ile kullanmak için OAuth jetonuna doğru kapsam atanmalıdır. Coğrafi Kodlama API'si aşağıdaki kapsamları destekler:

• https://www.googleapis.com/auth/maps-platform.geocode — Tüm Geocoding API uç noktalarıyla kullanılır.
• https://www.googleapis.com/auth/maps-platform.geocode.address — Yalnızca ileri coğrafi kodlama için GeocodeAddress ile birlikte kullanın.
• https://www.googleapis.com/auth/maps-platform.geocode.location — Tersine coğrafi kodlama için yalnızca GeocodeLocation ile kullanın.
• https://www.googleapis.com/auth/maps-platform.geocode.place — Yer coğrafi kodlaması için yalnızca GeocodePlace ile kullanılır.

Ayrıca, tüm Geocoding API uç noktaları için genel https://www.googleapis.com/auth/cloud-platform kapsamını kullanabilirsiniz. Bu kapsam, gcloud kullanılarak jeton oluşturulurken kullanılan varsayılan kapsam olduğundan geliştirme sırasında faydalıdır.

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

OAuth jetonu kullanarak Geocoding API'yi denemek istiyorsanız ancak jeton oluşturmak için ortam kurulumunuz yoksa bu bölümdeki prosedürü kullanarak çağrı yapabilirsiniz.

Bu örnekte, çağrı 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ını kullanarak Google API'lerini çağırmak için ADC'yi kullanma hakkında bilgi edinmek için İstemci kitaplıklarını kullanarak kimlik doğrulama başlıklı makaleyi inceleyin.

Not: REST çağrısı yapmak için aşağıdaki prosedürün üretim ortamında kullanılması amaçlanmamıştır. Bu prosedürü yalnızca geliştirme veya test ortamı için kullanın.

Ön koşullar

ADC kullanarak bir REST isteğinde bulunmadan önce Google Cloud CLI'yı kullanarak ADC'ye kimlik bilgileri sağlayın:

1. gcloud CLI'yı yükleyin ve başlatın.

2. Kimlik bilgisi dosyanızı oluşturmak için yerel makinenizde aşağıdaki gcloud komutunu çalıştırın:

   gcloud auth application-default login

3. Giriş ekranı gösterilir. Oturum açtıktan sonra kimlik bilgileriniz ADC tarafından kullanılan yerel kimlik bilgisi dosyasına kaydedilir.

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

REST isteğinde bulunma

Bu örnekte iki istek üstbilgisi iletiyorsunuz:

• Jetonu oluşturmak için aşağıdaki komutu kullanarak OAuth jetonunu Authorization üstbilgisinde iletin:

  gcloud auth application-default print-access-token

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

• Faturalandırmanın etkin olduğu Google Cloud projenizin kimliğini veya adını X-Goog-User-Project üstbilgisinde iletin.

Aşağıdaki örnekte, OAuth jetonu kullanılarak Geocoding API'ye çağrı yapılmaktadır.

1. Google Cloud projenizin kimliğini iletmek için PROJECT_ID alanını düzenleyin.

   curl -X GET -H 'Content-Type: application/json' \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
   

2. curl komutunu kopyalamak için kod örneğindeki kopyalama simgesini, , tıklayın.
3. Komutu bir terminal penceresine yapıştırıp çalıştırın.

Yanıt bir JSON nesnesi olur:

Sorun giderme

İsteğiniz, son kullanıcı kimlik bilgilerinin bu API tarafından desteklenmediğiyle ilgili bir hata mesajı döndürürse ADC kurulumunuzla ilgili sorunları giderme başlıklı makaleye bakın.