İ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. Müşteri kimliği için geçici olarak kendi kendine 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 Maps Platform Hizmetleri.
• İstemci kimliğinizi kullandığınız uygulamalar, siteler veya sistemler.

Google, Mayıs 2025'te müşteri 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 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:<numerical identifier>" seçeneğini belirleyin.
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. Şu adımları uygulayın:

1. Cloud Console'da Metrikler sayfasını açın.
2. Açılır listeden bir Haritalar Platformu hizmeti seçin.
3. Kullanımınızı aşağıdaki ayarlarla filtreleyin:
   • Kimlik bilgileri: Yalnızca "project_number:<numerical identifier>" seçeneğini belirleyin.
4. Aşağıdaki filtreyi ayarlayın.
   • Gruplandırma ölçütü: Platform veya Alan
5. Trafiği kontrol etmeniz gereken her Maps Platform 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 projedeki bir 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ı tekrar kullanabilirsiniz.
   • Aynı Cloud projesinden birden fazla API anahtarı kullanabilirsiniz. Örneğin, her Maps Platform hizmetinin trafiğini ayırmak veya farklı platformlardan (tarayıcı, mobil uygulama vb.) gelen trafiği ayırmak için. 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ı ayarlayın (ör. web siteleri, IP adresleri, Android uygulamaları veya iOS uygulamaları).
• API anahtarınız için API kısıtlamaları ayarlayın.

Daha fazla bilgi için Google Haritalar Platformu güvenlik rehberi başlıklı makaleyi 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üvenilen yönlendirenlerin listesini Cloud Console'da bulabilirsiniz.

Kota ayarlarını inceleme

Cloud projenizde beklenen kota ayarlarının bulunduğundan emin olun. Bu işlemi 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 edebilir ve düzenleyebilirsiniz.

Kota raporları hakkında daha fazla bilgi edinin.

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ı inceleyin, 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.
   • Kullanımınızı aşağıdaki ayarlarla filtreleyin:
     • Gruplandırma ölçütü: API Yöntemi
     • Kimlik bilgileri: Yalnızca "project_number:<numerical identifier>" seçeneğini belirleyin.
   • 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.
• Müşteri kimliği kota kullanımınızı tahmin etme
  • Hizmetlerin her biri için hem Saniyede hem de Günde ayrıntı düzeyini kontrol edin.
  • Saniye Başına Grafiği: Dakika başına ek kota ihtiyaçları için en yüksek trafiği 60 ile çarpın.
  • Günlük grafik: En yoğun trafik, günlük ek kota ihtiyacı olmalıdır.
• İlgili Haritalar Platformu hizmetlerindeki 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 isteklerinizde kanal parametresini belirterek kanallara göre 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'ya göz atı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 imza parametresini API isteklerinizden kaldırın.

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

Daha fazla bilgi için Premium Planına Genel Bakış başlıklı makaleyi inceleyin.

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

Maps Static API ve Street View Static API, imza parametresini gerektirmeye devam ediyor. Test amacıyla imza olmadan az sayıda isteği kabul ediyorlar ancak üretiminizde eşiğe ulaşıldığında başarısız olmaya başlıyorlar. İmza gizlinizi, istemci kimliği için olanla API anahtarı için olanla değiştirin. Aynı imza algoritmasını kullanabilirsiniz ancak başka bir imza gizlisi kullanmanız gerekir. Daha fazla bilgi edinmek için Dijital İmza Kullanma başlıklı makaleyi inceleyin.

Müşteri kimliği trafiğinizi izleme

Dağıtımın ardından, 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 istemci kimliği trafiğinizde düşüş görmeye başlarsınız.

Müşteri 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, önbellekler, botlar vb.) ve iş üzerinde etki yaratmadan hatalar döndürebileceğini onaylamak 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 için geçici olarak yeniden etkinleştirme self servisi

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 işlemi 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 kendi kendine hizmet etkinleştirme işlemi gerçekleştirebilirsiniz:

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

API anahtarlarına hızlı bir şekilde geçemiyorsanız ve geçici olarak daha fazla kesintiden muaf olmak istiyorsanız lütfen aşağıdaki ayrıntılarla birlikte Google Haritalar Platformu Destek Ekibi ile iletişime geçin:

• Müşteri Kimliği
• Belirli kullanım alanı
• Hedeflenen taşıma tarihi
• İşletme etki değerlendirmesi

Faturalandırma raporlarındaki Client-ID kullanım raporu

Proje metriklerine erişimi olmayan kullanıcılar (ör. faturalandırma yöneticileri, özellikle Maps Platform İş Ortakları) için proje metrikleri yerine faturalandırma raporlarını kontrol etmek yararlı olabilir. Faturalandırma raporlarında 1-2 günlük gecikme olsa da 30 günden fazla kullanım ve maliyet analizleri gösterilir.

Aşağıdaki adımları uygulayarak Google Cloud Console üzerinden istemci kimliği kullanımını 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. Rapor verilerini etiket anahtarına göre gruplandırın goog-maps-api-key-suffix. Bu etiket, API anahtarının son karakterlerini gösterir.
4. İstemci kimliği trafiğini belirlemek için goog-maps-api-key-suffix etiketinin eksik veya boş olduğu girişleri arayın. Bu etiket, istemci kimliği istekleri için doldurulmaz.
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ın güvenliğini sağlama" bölümüne bakın ve alanınızı API anahtarına ekleyin.

OverQuotaMapError veya OVER_QUERY_LIMIT hatası

Yapılandırılan kotanız 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"
}