İstemci Kimliği Taşıma Rehberi

Genel Bakış

Başlamak için aşağıdaki adımları izleyin:

1. Mevcut istemci kimliği kullanımını kontrol etme
2. API anahtarlarını hazırlama
3. Kota ayarlarını inceleme
4. Kodunuzu güncelleme
5. İstemci kimliği trafiğinizi izleme
6. İstemci kimliğinizi duraklatma
7. İstemci kimliğini self servis geçici olarak yeniden etkinleştirme

Mevcut istemci kimliği kullanımını kontrol etme

Taşıma işlemine başlamadan önce aşağıdakileri listeleyin:

• İstemci kimliğinizle kullandığınız Haritalar Platformu hizmetleri.
• İstemci kimliğinizi kullandığınız uygulamalar, siteler veya sistemler.

Google, Mayıs 2025'te istemci kimliğinin kullanımdan kaldırılmasıyla ilgili olarak etkilenen müşterilere bir bildirim e-postası gönderdi. Bu bilgileri bildirim e-postasında da bulabilirsiniz.

Cloud Console'da, istemci kimliği kullanımınızın en son durumunu Google Haritalar Metrikleri sayfasında kontrol edebilirsiniz.

Haritalar Platformu hizmetlerinin listesi için:

1. Cloud Console'da Metrikler sayfasını açın.
2. Kullanımınızı aşağıdaki ayarlarla filtreleyin:
   • Kimlik bilgileri: Yalnızca "project_number:<sayısal tanımlayıcı>"yı seçin.
3. Aşağıdaki filtreyi ayarlayın.
   • Gruplandırma ölçütü: API

Uygulamalar, siteler veya sistemlerle ilgili ipuçları için:

Cloud Console; uygulamalarınızın, sitelerinizin veya sistemlerinizin ayrıntılarını göstermez. Ancak istemci kimliği trafiğinizin kaynaklarıyla ilgili bazı ipuçları bulabilirsiniz. Şu adımları uygulayın:

1. Cloud Console'da Metrikler sayfasını açın.
2. Açılır menüden bir Maps Platform hizmeti seçin.
3. Kullanımınızı aşağıdaki ayarlarla filtreleyin:
   • Kimlik bilgileri: Yalnızca "project_number:<sayısal tanımlayıcı>"yı seçin.
4. Aşağıdaki filtreyi ayarlayın.
   • Gruplandırma ölçütü: Platform veya Alan
5. Trafiğini kontrol etmeniz gereken her Haritalar Platformu hizmeti için 2. adımdan itibaren tekrarlayın.

API anahtarlarını hazırlama

Tüm istemci kimlikleri bir Google Cloud projesiyle ilişkilendirilir. Bu projeden bir API anahtarı kullanmak, daha önce istemci kimliğinizle eriştiğiniz özelliklere erişmenizi sağlar. Kota veya eksik özelliklerle ilgili sorun yaşamamak için ilişkili projeye geçmenizi öneririz.

1. İstemci kimliğinizin bağlı olduğu Cloud projesini bulun:
   • Portal taşıma ile ilgili SSS
2. Cloud projenizin açık bir faturalandırma hesabına bağlı olduğundan emin olun.
3. İstemci kimliği taşıma işlemi için yeni bir API anahtarı oluşturun.
   • Cloud projesindeki mevcut API anahtarlarını yeniden kullanabilirsiniz.
   • Aynı Cloud projesinden birden fazla API anahtarı kullanabilirsiniz. Örneğin, her bir Maps Platform hizmetinin trafiğini ayırmak veya farklı platformlardan (tarayıcı, mobil uygulama vb.) gelen trafiği ayırmak için bu yöntemi tercih edebilirsiniz. API anahtarı yönetimiyle ilgili en iyi uygulamalar için güvenlik kılavuzuna bakın.

API anahtarınızın güvenliğini sağlama

Anahtarınızı yetkisiz erişime karşı korumak için API anahtarınızın güvenliğini sağladığınızdan emin olun.

• API anahtarınız için bir uygulama kısıtlaması (ör. web siteleri, IP adresleri, Android uygulamaları veya iOS uygulamaları) ayarlayın.
• API anahtarınız için API kısıtlamaları ayarlayın.

Daha fazla bilgi için Google Haritalar Platformu güvenlik kılavuzunu inceleyin.

Maps JavaScript API, Maps Static API ve Street View Static API için istemci kimliğinizdeki güvenilir yönlendirenleri API anahtarı kısıtlamalarına taşıyabilirsiniz. Güvenilir yönlendirenlerin listesini Cloud Console'da bulabilirsiniz.

Kota ayarlarını inceleme

Cloud projenizde beklenen kota ayarlarının yapıldığından emin olun. Bunu yalnızca Maps JavaScript API istemci tarafı hizmetlerini bir istemci kimliğinden çağırıyorsanız yapmanız gerekir. Kota ayarlarınızı Google Haritalar Kota Sayfası'ndan kontrol edip düzenleyebilirsiniz.

Kota raporları hakkında daha fazla bilgi

Maps JavaScript API istemci tarafı hizmetleri için kota artışı

Maps JavaScript API'de aşağıdaki hizmetleri kullanıyorsanız API anahtarı taşıma işleminden sonra kota kullanımının arttığını görürsünüz.

Mevcut kota yapılandırmanızı ve mevcut kullanımınızı inceleyip kota sınırlarınızı buna göre ayarlayın.

1. Maps JavaScript API istemci tarafı hizmetlerini bir istemci kimliğiyle kullanıp kullanmadığınızı kontrol edin.
   • Cloud Console'da Metrikler sayfasını açın.
   • Kullanımınızı aşağıdaki ayarlarla filtreleyin:
     • Gruplandırma ölçütü: API yöntemi
     • Kimlik bilgileri: Yalnızca "project_number:<sayısal tanımlayıcı>"yı seçin.
   • Ardından, "API Yöntemine Göre Trafik" grafiğinde, trafiğiyle birlikte yöntem adlarının listesini görürsünüz.

• Bu API yöntemlerini kullanmıyorsanız istemci kimliği trafiğiniz projenizin kotasını zaten tükettiği için kota ayarları konusunda endişelenmeniz gerekmez.
• İstemci kimliği kota kullanımınızı tahmin etme
  • Hizmetlerin her biri için hem saniye başına hem de gün başına ayrıntı düzeyini kontrol edin.
  • Saniye Başına grafiği: Ek Dakika Başına Kota ihtiyaçları için en yüksek trafiği 60 ile çarpın.
  • Günlük grafik: En yüksek trafik, günlük ek kota ihtiyacı olmalıdır.
• İlgili Haritalar Platformu hizmetlerinde kotanızı ayarlayın.
  • 1. adımda bulduğunuz yöntem adına göre ilgili hizmetlerdeki kotayı ayarlayın.

Kodunuzu güncelleme

İstemci parametresini anahtar parametresiyle değiştirme

Giden GMP API çağrılarınızda kimlik doğrulama bilgilerini URL&client={value} yerine URL&key={value} olarak güncelleyin. Uygulamalarınız GMP hizmetlerine erişmek için HTTP kullanıyorsa bunları HTTPS kullanacak şekilde güncelleyin.

Raporlama için kanal parametresini güncelleme

API isteklerinize kanal parametresini ekleyerek kanal başına kullanımınızı takip edebilirsiniz. API anahtarları, kanal parametresi için yalnızca sayısal değerleri destekler. Kanal parametresi için istemci kimliğinizi sayısal olmayan değerlerle kullanıyorsanız desteklenen sayısal değerlerle güncelleyin.

Daha fazla bilgi için Google Haritalar Platformu Raporlama sayfasına bakın.

Web hizmetleri için imza parametresini kaldırma

Aşağıdaki Web Hizmeti API'lerine API anahtarıyla eriştiğinizde imza parametresi gerekmez. Yalnızca API isteklerinizden imza parametresini kaldırın.

• Directions API (Eski)
• Distance Matrix API (Eski)
• Geocoding API
• Elevation API
• Time Zone API

Daha fazla bilgi için Premium Plan'a Genel Bakış sayfasını inceleyin.

Imagery API'leri için imzalama gizli anahtarı

Maps Static API ve Street View Static API için imza parametresi hâlâ gereklidir. Test amacıyla imzasız az sayıda isteği kabul ederler ancak üretiminizde eşiğe ulaştığında başarısız olmaya başlarlar. İmzalama gizli anahtarınızı istemci kimliği için olandan API anahtarı için olana değiştirin. Aynı imzalama algoritmasını kullanabilirsiniz ancak başka bir imzalama gizli anahtarı kullanmanız gerekir. Daha fazla bilgi için Dijital imza kullanma başlıklı makaleyi inceleyin.

İstemci kimliği trafiğinizi izleme

Dağıtımdan sonra, Cloud Console kontrol panellerini kullanarak trafiğinizin başarıyla taşındığını onaylayın. Kimlik bilgisine göre gruplandırma ölçütü yaparken kontrol panelinde "project_number:123456" biçiminde gösterilen istemci kimliği trafiğinizde azalma görmeye başlarsınız.

İstemci kimliğinizi duraklatma

Geliştiricilerin, taşıma işleminden sonra istemci kimliklerini duraklatmasını önemle tavsiye ederiz. Bu, kimlik bilgilerinizi istenmeyen trafikten korumak ve istemci kimliğinizdeki kalan kullanımın kritik olmadığını (ör.test, önbellek, bot vb.) ve işletme üzerinde etki yaratmadan hata döndürebileceğini doğrulamak içindir. İstemci kimliğinizi Cloud Console'da duraklatabilirsiniz. Daha fazla bilgi için Premium Plan Kimlik Doğrulamasına Genel Bakış başlıklı makaleyi inceleyin.

İstemci kimliği self servis geçici yeniden etkinleştirme

Google Haritalar Platformu istemci kimlikleri, Mayıs 2026'da aşamalı olarak kullanımdan kaldırılma dönemine girdiğinden hizmet kullanılabilirliği artık garanti edilmemektedir. Planlanan hizmet sonlandırma süreci kapsamında erişim, belirli aralıklarla kısıtlanacak. Hizmet genellikle birkaç saat içinde otomatik olarak geri yüklenir ancak hemen geri yüklenmesi gerekiyorsa erişimi manuel olarak yeniden etkinleştirebilirsiniz.

Erişimi acilen geri yüklemek için Google Cloud Console üzerinden self servis yeniden etkinleştirme işlemi gerçekleştirebilirsiniz:

• Google Haritalar Platformu Kimlik Bilgileri sayfasına gidin.
• İstemci kimliğinize bağlı olan Cloud projenizi bulun.
• Hizmeti geri yüklemek için girişin en sağındaki devam ettir simgesini tıklayın.

API anahtarlarına hızlı bir şekilde geçiş yapamıyorsanız ve daha fazla kesintiden geçici olarak muaf tutulmak istiyorsanız lütfen aşağıdaki bilgileri sağlayarak Google Haritalar Platformu Destek Ekibi ile iletişime geçin:

• İstemci Kimliği
• Özel kullanım alanı
• Hedeflenen taşıma tarihi
• İşletme üzerindeki etki değerlendirmesi

İstemci kimliği kullanım raporu (Fatura Raporları'ndan)

Proje metriklerine erişimi olmayan kullanıcılar (ör. faturalandırma yöneticileri, özellikle de Google Maps Platform iş ortakları) proje metrikleri yerine fatura raporlarını kontrol edebilir. Fatura raporlarında 1-2 günlük gecikme olsa da 30 günden uzun süreli kullanım ve maliyet analizlerini gösterme avantajı vardır.

İstemci kimliği kullanımını Google Cloud Console üzerinden izlemek için aşağıdaki adımları uygulayın:

1. Google Cloud Console'da Faturalandırma > Raporlar sayfasına gidin.
2. (İsteğe bağlı, yalnızca iş ortakları için geçerlidir) İstediğiniz alt faturalandırma hesabını seçmek için bir filtre uygulayın.
3. Raporlama verilerini goog-maps-api-key-suffix etiket anahtarına göre gruplandırın. Bu etiket, API anahtarının son karakterlerini gösterir.
4. İstemci kimliği istekleri için bu etiket doldurulmadığından, goog-maps-api-key-suffix etiketinin eksik veya boş olduğu girişleri arayarak istemci kimliği trafiğini belirleyin.
5. API istekleriyle ilişkilendirilmesi amaçlanmayan SKU'ları (ör. abonelik SKU'ları) yoksayın.

Sorun giderme

İsteğimizin başarısız olup olmadığını nasıl görebiliriz?

Hata istatistiklerinizi Yanıt kodu grafiklerinde kontrol edebilirsiniz.

ApiNotActivatedMapError veya REQUEST_DENIED hatası

Cloud projenizde hizmeti etkinleştirmediyseniz ApiNotActivatedMapError veya REQUEST_DENIED hatasını görürsünüz. Hizmeti etkinleştirmek için talimatları uygulayın.

RefererNotAllowedMapError hata

Kaynak alanınız API anahtarınıza eklenmemişse RefererNotAllowedMapError hatasını görürsünüz. "API anahtarınızın güvenliğini sağlama" bölümünü inceleyin ve alanınızı API anahtarına ekleyin.

OverQuotaMapError veya OVER_QUERY_LIMIT hatası

Yapılandırılmış kotanız trafiğinizi karşılamaya yetmiyorsa OverQuotaMapError veya OVER_QUERY_LIMIT hatasını görürsünüz. "Kota ayarlarını inceleme" bölümünü kontrol edin ve kotanızı buna göre ayarlayın.

"Requests to this API must be over SSL" (Bu API'ye gönderilen istekler SSL üzerinden olmalıdır) hatası

Aşağıdaki hata mesajını alırsanız API isteklerinizi "http://" yerine "https://" olarak güncelleyin.

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}