Genel Bakış
Kimlik doğrulama güvenliğini ve güvenilirliğini artırmak için Haritalar Platformu istemci kimliklerinin desteği 26 Mayıs 2025'te sonlandırıldı ve bu kimlikler 31 Mayıs 2026'dan sonra kullanılamayacak.
Google Haritalar API hizmeti trafiğinizin kimliğini doğrulamak için istemci kimliği yerine API anahtarı kimlik bilgilerini kullanmanız gerekir. Bu kılavuzda, istemci kimliklerini kullanmaktan API anahtarlarını kullanmaya nasıl geçeceğiniz gösterilmektedir.
Başlamak için aşağıdaki adımları izleyin:
- Mevcut istemci kimliği kullanımını kontrol etme
- API anahtarlarını hazırlama
- Kota ayarlarını inceleme
- Kodunuzu güncelleme
- İstemci kimliği trafiğinizi izleme
- İstemci kimliğinizi duraklatma
Mevcut istemci kimliği kullanımını kontrol etme
Taşıma işlemine başlamadan önce aşağıdakileri listeleyin:
- Müşteri kimliğinizle birlikte kullandığınız Haritalar Platformu 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, istemci kimliği kullanımınızın en son durumunu Google Haritalar Metrikleri Sayfası'nda kontrol edebilirsiniz.
Haritalar Platformu Hizmetleri listesi için:
- Cloud Console'da Metrikler sayfasını açın.
- Kullanımınızı aşağıdaki ayarlarla filtreleyin:
- Kimlik bilgileri: Yalnızca "project_number:<numerical identifier>" seçeneğini belirleyin.
- 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. Aşağıdaki adımları uygulayın:
- Cloud Console'da Metrikler sayfasını açın.
- Açılır listeden bir Haritalar Platformu hizmeti seçin.
- Kullanımınızı aşağıdaki ayarlarla filtreleyin:
- Kimlik bilgileri: Yalnızca "project_number:<numerical identifier>" seçeneğini belirleyin.
- Aşağıdaki filtreyi ayarlayın.
- Gruplandırma ölçütü: Platform veya Alan
- 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 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.
- İstemci kimliğinizin bağlı olduğu Cloud projesini bulun:
- Cloud projenizin açık bir faturalandırma hesabına bağlı olduğundan emin olun.
- İ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ı platformlardaki (tarayıcı, mobil uygulama vb.) trafiği ayırmak için bu anahtarları kullanabilirsiniz. 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. 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 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.
- 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:<numerical identifier>" seçeneğini belirleyin.
- Ardından, "API Yöntemine Göre Trafik" grafiğinde trafikle birlikte yöntem adlarının listesini görürsünüz.
API Yöntemi |
İstemci tarafı hizmeti |
Kotanın ayarlanacağı hizmet |
google.routes.Directions.Javascript |
Yol Tarifi Hizmeti |
Directions API |
google.routes.DistanceMatrix.Javascript |
Distance Matrix Hizmeti |
Distance Matrix API |
google.maps.Elevation.Javascript |
Yükseklik Hizmeti |
Elevation API |
google.places.Geocoding.Javascript |
Coğrafi Kodlama Hizmeti |
Geocoding API |
google.places.Geocoding.Javascript dışındaki google.places.*.Javascript |
Yerler Kitaplığı |
Places API |
- Bu API yöntemlerini kullanmıyorsanız kota ayarlarıyla ilgili endişelenmenize gerek yoktur. İstemci kimliği trafiğiniz zaten proje kotanızı tüketir.
- Müşteri kimliği kota kullanımınızı tahmin etme
- Her hizmet için hem saniye başına hem de gün başına 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 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 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 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ı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 için imza parametresi hâlâ gereklidir. Test amacıyla imzası olmayan az sayıda isteği 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 olan anahtardan API anahtarı için olan anahtarla değiştirin. Aynı imzalama algoritmasını kullanabilirsiniz ancak başka bir imzalama gizlisi kullanmanız gerekir. Daha fazla bilgi için Dijital İmza Kullanma başlıklı makaleyi inceleyin.
Müşteri kimliği trafiğinizi izleme
Dağıtımdan sonra Cloud Console kontrol panellerini kullanarak trafiğinizin başarıyla taşındığını doğrulayı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.
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 Authentication Overview (Premium Plan Kimlik Doğrulamasına Genel Bakış) başlıklı makaleyi inceleyin.
Sorun giderme
İsteğimizin başarısız olup olmadığını nasıl görebiliriz?
Hata istatistiklerinizi Yanıt kodu grafikleri'nde 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ı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"
}