İ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ı inceleyin
4. Kodunuzu güncelleme
5. İstemci kimliği trafiğinizi izleme
6. İstemci kimliğinizi duraklatma
7. İstemci kimliği self servis geçici 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 desteğinin sonlandı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, Google Haritalar Metrikleri Sayfası'nda istemci kimliği kullanımınızın en son durumunu kontrol edebilirsiniz.

Haritalar Platformu Hizmetleri'nin listesi için:

1. Cloud Console'da Metrikler sayfasını açın.
2. Aşağıdaki ayarlarla kullanımınızı 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östermiyor. Ancak, istemci kimliği trafiğinizin kaynaklarıyla ilgili bazı ipuçları bulabilirsiniz. Aşağıdaki 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.
   • Şuna göre gruplandır: Platform veya Alan
5. Trafiği 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 ve bu projenin API anahtarını kullanarak, daha önce istemci kimliğinizle eriştiğiniz özelliklere erişebilirsiniz. Kotalarla ilgili sorunları veya eksik özellikleri önlemek 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ı güvene alma

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 rehberine bakın.

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üvenilen yönlendirenlerin listesini Cloud Console'da bulabilirsiniz.

Kota ayarlarını inceleme

Cloud projenizde beklenen kota ayarlarının olduğundan emin olun. Bunu yalnızca istemci kimliğinden Maps JavaScript API istemci tarafı hizmetlerini ç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 edinin.

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

Haritalar 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 istemci kimliğiyle kullanıp kullanmadığınızı kontrol edin.
   • Cloud Console'da Metrikler sayfasını açın.
   • Aşağıdaki ayarlarla kullanımınızı filtreleyin:
     • Şuna göre gruplandırılmış: 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, trafikle birlikte yöntem adlarının bir listesini görürsünüz.

• Bu API yöntemlerini kullanmıyorsanız istemci kimliği trafiğiniz proje kotanızı zaten kullandığı için kota ayarlarıyla ilgili endişelenmenize gerek yoktur.
• İstemci kimliği kota kullanımınızı tahmin etme
  • Her hizmet için hem saniyede hem de günde 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 yoğun trafik, gereken ek günlük kotayı göstermelidir.
• İ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 kimlik 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. Müşteri kimliğinizi kanal parametresi için 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ış bölümünü inceleyin.

Görüntü API'leri için İmzalama Gizli Anahtarı

Maps Static API ve Street View Static API için imza parametresi hâlâ gereklidir. Test amacıyla küçük bir imzasız istek sayısını kabul ederler ancak üretiminizde eşiğe ulaşıldığı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 gizlisi 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. Kimliğe göre gruplandırıldığında kontrol panelinde "project_number:123456" biçiminde gösterilen müşteri kimliği trafiğinizde düşüş 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, botlar 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 desteği sonlandı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ıtlanacaktır. 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 acil olarak 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 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 Maps Platform İş Ortakları) için proje metrikleri yerine fatura raporlarını kontrol etmek yararlı olabilir. 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ı sunarlar.

İstemci kimliği kullanımını Google Cloud Console üzerinden şu adımları uygulayarak izleyebilirsiniz:

1. Google Cloud Console'da Faturalandırma > Raporlar sayfasına gidin.
2. (İsteğe bağlı, yalnızca iş ortakları için geçerlidir) İstenen alt faturalandırma hesabını seçmek için filtre uygulayın.
3. Raporlama verilerini etiket anahtarına göre gruplandırın goog-maps-api-key-suffix. Bu etiket, API anahtarının sondaki 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şkilendirilmemesi gereken 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 grafikleri bölümünden 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ştirme talimatlarını 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ı güvenli hale getirme" bölümünü inceleyin ve alanınızı API anahtarına ekleyin.

OverQuotaMapError veya OVER_QUERY_LIMIT hatası

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

"Bu API'ye yapılan 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"
}