
REQUEST_DENIED, Maps Platform'un bir web servisi isteğini reddettiği anlamına gelir. Geocoding API gibi servislerde en sık nedenler, anahtara konmuş yanlış uygulama kısıtı, projede etkinleştirilmemiş API ya da projeye bağlı olmayan faturalama hesabıdır. Yanıttaki error_message alanı hangisi olduğunu çoğu zaman doğrudan söyler.
REQUEST_DENIED hatası neden oluşur
Google'ın Geocoding belgesi bu durumu yalnızca "isteğiniz reddedildi" diye tanımlar. Reddin nedeni, yanıta eklenebilen error_message alanında yazar. Belgeye göre bu alan her yanıtta bulunmayabilir ve içeriği değişebilir. Bu yüzden önce ham yanıtı görmek gerekir.
Google'ın Maps SSS sayfası ve geliştirici belgeleri esas alınarak (kontrol tarihi 17 Kasım 2026) sık görülen nedenler aşağıdadır.
| Yanıttaki ya da konsoldaki ifade | Anlamı | Çözüm |
|---|---|---|
| API keys with referer restrictions cannot be used with this API. | Web servisi isteğinde HTTP yönlendiren (referrer) kısıtlı anahtar kullanılıyor | Anahtarın kısıtını IP adresi olarak değiştirin ya da sunucu için ayrı anahtar oluşturun |
| This IP, site or mobile application is not authorized to use this API key. | İstek, anahtardaki IP, site, Android ya da iOS kısıtına uymuyor | Kimlik Bilgileri sayfasında kısıtı kontrol edin |
| Projede faturalama hesabı yok | Maps Platform ürünleri faturalama hesabı ister | Projeye faturalama hesabı bağlayın |
| API etkin değil | İstek yapılan API projede açılmamış | API'yi Google Cloud konsolunda etkinleştirin |
Tarayıcıdaki harita hatası hangi koddan anlaşılır
Harita bir web sayfasında Maps JavaScript API ile yükleniyorsa hata REQUEST_DENIED olarak değil, tarayıcı konsolunda ayrı bir kodla görünür. Google'ın hata mesajları sayfasındaki karşılıklar şöyledir.
| Konsoldaki kod | Anlamı | Yapılacak |
|---|---|---|
| ApiNotActivatedMapError | Maps JavaScript API projede etkin değil | API'yi konsoldan etkinleştirin |
| ApiTargetBlockedMapError | Anahtarın API kısıtlarında bu servis yok | Gereken tüm API'leri kısıt listesine ekleyin |
| BillingNotEnabledMapError | Projede faturalama açık değil | Faturalamayı etkinleştirin |
| RefererNotAllowedMapError | Sayfanın adresi anahtardaki izinli adresler arasında değil | Adresi anahtarın Web siteleri kısıtına ekleyin |
| InvalidKeyMapError | Anahtar bulunamadı | Doğru anahtarı kullanın ya da yenisini üretin |
| MissingKeyMapError | Haritayı yükleyen kodda key parametresi yok | Geçerli bir key parametresi ekleyin |
| ExpiredKeyMapError | Anahtarın süresi dolmuş ya da henüz tanınmıyor | Birkaç dakika bekleyin, olmazsa yeni anahtar üretin |
Aynı sayfa, ClientId ile yüklenen haritalar için bir tarih verir. InvalidClientIdMapError hatasına göre müşteri kimlikleri kullanımdan kalkmıştır ve 31 Mayıs 2026'dan sonra kullanılamaz. Hâlâ ClientId ile yükleme yapan bir siteniz varsa API anahtarına geçirin.
REQUEST_DENIED hatası nasıl çözülür
- Ham yanıtı okuyun. Tarayıcıdan ya da sunucu günlüğünden isteğin tam yanıtını alın ve error_message alanına bakın. Tarayıcıda haritaysa geliştirici araçlarındaki konsolda yukarıdaki kodlardan birini arayın.
- İsteği hangi API'nin yaptığını belirleyin. Geocoding, Routes ve Places gibi sunucudan çağrılan web servisleri ile Maps JavaScript API farklı kısıt türleri ister.
- API'nin projede etkin olduğunu doğrulayın. Google Cloud konsolunda ilgili API'nin sayfasını açın. Etkinse Yönet düğmesi görünür, değilse Etkinleştir düğmesi çıkar. Komut satırında Maps JavaScript API için
gcloud services enable --project "PROJE" "maps-backend.googleapis.com"komutu kullanılır. Etkinleştirdikten sonra isteklerin çalışması birkaç dakika sürebilir. - Faturalama hesabının projeye bağlı olduğunu doğrulayın. Ayrıntılı adımlar için faturalama hesabı bağlı değil yazımıza bakın.
- Anahtarın kısıtlarını kontrol edin. Google Maps Platform altında Anahtarlar ve Kimlik Bilgileri sayfasından anahtarı açın. Uygulama kısıtı ile API kısıtının, çağrılan API'ye uyduğunu doğrulayın.
- Değişiklikten sonra yeniden deneyin. Etkinleştirme ve anahtar değişikliklerinin geçerli olması birkaç dakika alabilir. Hemen sonuç görmezseniz bir süre bekleyip tekrar deneyin.
Hangi anahtar hangi kısıtla kullanılır
Bir anahtarda tek tür uygulama kısıtı bulunur ve anahtar yalnızca o platformda çalışır. REQUEST_DENIED hatasının en yaygın kaynağı, tarayıcı için üretilmiş bir anahtarın sunucu kodunda kullanılmasıdır. Google'ın API güvenliği sayfasındaki eşleştirme şöyledir.
| Kullanım | Uygulama kısıtı |
|---|---|
| Geocoding API, Routes API, Roads API gibi sunucu taraflı web servisleri | IP adresleri |
| Maps JavaScript API, Maps Static API, Street View Static API | Web siteleri (HTTP yönlendiren) |
| Maps SDK for Android, Places SDK for Android | Android uygulamaları (paket adı ve SHA-1 parmak izi) |
| Maps SDK for iOS, Places SDK for iOS | iOS uygulamaları (paket kimliği) |
| Maps Embed API | Yalnızca bu API'ye kısıtlı ayrı anahtar, isteğe bağlı Web siteleri kısıtı |
Hem haritayı tarayıcıda gösteren hem de sunucudan adres çözümleyen bir uygulamada iki ayrı anahtar kullanın. Tarayıcı anahtarı Web siteleri kısıtlı olur ve Maps JavaScript API'ye açılır. Sunucu anahtarı IP adresi kısıtlı olur ve yalnızca sunucunun çağırdığı API'lere açılır. IP kısıtı olan anahtar yalnızca sunucu taraflı web servislerinde kullanılabilir, tarayıcıda çalışmaz.
Web sitesi kısıtında adres nasıl yazılır
İzinli adres, protokol, ana makine adı ve isteğe bağlı port içeren tam bir yönlendiren adresi olmalıdır. Google tüm alt alan adları için yıldız kullanılabileceğini belirtir. Yol içeren adres yazılmamalıdır, çünkü tarayıcılar farklı kaynaktan gelen isteklerde yolu çoğu zaman keser.
https://ornek.com.tr
https://*.ornek.com.tr
Hem www'lu hem www'suz adresten harita açılıyorsa ikisini de ekleyin. Sitenin test ortamı farklı bir alan adındaysa onu da listeye almak gerekir, yoksa canlıda çalışan harita test ortamında RefererNotAllowedMapError verir.
Anahtar kısıtlanmazsa ne olur
Kısıtı kaldırınca hata geçebilir ama bu doğru çözüm değildir. Google'ın anahtar alma sayfasına göre kısıtsız bir anahtar herhangi bir Maps Platform servisiyle kullanılabilir ve kötüye kullanımdan doğan ücretlerden anahtarın sahibi sorumludur. Kısıtı geçici olarak kaldırdıysanız tanıdığınız IP ya da adreslere göre yeniden koyun.
Ücretlendirme de hata nedenleriyle iç içedir, çünkü her ürün için faturalama hesabı gerekir. Google'ın fiyat sayfasına göre (kontrol tarihi 17 Kasım 2026) aylık ücretsiz kullanım sınırı SKU grubuna göre değişir.
| Grup | Aylık ücretsiz kullanım | Örnek SKU |
|---|---|---|
| Essentials | 10.000 çağrı | Dynamic Maps, Geocoding, Static Maps, Time Zone |
| Pro | 5.000 çağrı | Elevation, Dynamic Street View, Nearby Search Pro |
| Enterprise | 1.000 çağrı | Places Details Enterprise, Text Search Enterprise |
Bazı SKU'larda sınır farklıdır. Örneğin 2D Map Tiles için 100.000 çağrı verilir. Maliyet tahmini için güncel SKU listesine bakın. Bulut maliyetlerini izlemek için bütçe uyarısı yazımızdaki adımlar bu projede de işe yarar.
Çözülmezse neye bakmalı
- error_message boşsa isteği aynı anahtarla başka bir ortamdan, örneğin kendi bilgisayarınızdan deneyin. Hatanın hangi ortama özgü olduğunu bulursunuz.
- Sunucunun çıkış IP adresi değişmiş olabilir. Bulut ortamlarında IP kısıtı olan anahtar, adres değişince reddedilir.
- Sunucunun NAT arkasındaysa kısıta özel adres değil, Google'ın gördüğü genel IP adresi yazılmalıdır.
- Anahtarın API kısıt listesinde, kullandığınız servisin eşleşen API'si olup olmadığına bakın. Maps JavaScript API içindeki Geocoding servisi için Geocoding API, Places kitaplığı için Places API de listede olmalıdır.
- Google'ın hata sayfasına göre siteyi siz yönetmiyorsanız bu hataları düzeltmek elinizde değildir. Site sahibine bildirin.
Harita ya da adres çözümleme hatası canlı bir siteyi veya uygulamayı etkiliyorsa bu işi sizin yerinize yapabiliriz. Anahtar yapısını, kısıtları ve faturalamayı birlikte düzenlemek için bize yazın. Ürünün genel çerçevesi için Google Maps Platform sayfamıza göz atabilirsiniz.
Kaynaklar
Bu sayfadaki bilgiler aşağıdaki kaynaklara dayanır. Ürün ve mevzuat değişebilir, kaynakları da kontrol edin.
- Maps JavaScript API: Hata mesajları
ApiNotActivatedMapError, RefererNotAllowedMapError ve diğer hata kodlarının anlamı.
- Google Maps Platform: Sık sorulan sorular
Referer kısıtlı anahtarın web servislerinde kullanılamaması.
- Google Maps Platform: API güvenliği önerileri
Uygulama kısıtı türleri ve hangi API'de hangisinin kullanılacağı.
- Geocoding API: İstek ve yanıt
REQUEST_DENIED durum kodu ve error_message alanı.
- Google Maps Platform: Fiyatlandırma
SKU gruplarına göre aylık ücretsiz kullanım sınırları.





