İçeriğe geç
Ücretsiz e-posta güvenlik testi: alan adınızın SPF, DKIM ve DMARC puanını 10 saniyede görün
Xen Bilişim

Sorun çözümü

Google Maps API REQUEST_DENIED Hatası Nasıl Çözülür (2026)

İsmet Öztürk · · 5 dk okuma

REQUEST_DENIED hatasında dört adım: error_message metnini okuyun, API'nin etkin olduğunu doğrulayın, faturalama hesabını bağlayın, anahtar kısıtını API'ye uydurun

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 ifadeAnlamıÇö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ıyorAnahtarı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 uymuyorKimlik Bilgileri sayfasında kısıtı kontrol edin
Projede faturalama hesabı yokMaps Platform ürünleri faturalama hesabı isterProjeye 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 kodAnlamıYapılacak
ApiNotActivatedMapErrorMaps JavaScript API projede etkin değilAPI'yi konsoldan etkinleştirin
ApiTargetBlockedMapErrorAnahtarın API kısıtlarında bu servis yokGereken tüm API'leri kısıt listesine ekleyin
BillingNotEnabledMapErrorProjede faturalama açık değilFaturalamayı etkinleştirin
RefererNotAllowedMapErrorSayfanın adresi anahtardaki izinli adresler arasında değilAdresi anahtarın Web siteleri kısıtına ekleyin
InvalidKeyMapErrorAnahtar bulunamadıDoğru anahtarı kullanın ya da yenisini üretin
MissingKeyMapErrorHaritayı yükleyen kodda key parametresi yokGeçerli bir key parametresi ekleyin
ExpiredKeyMapErrorAnahtarın süresi dolmuş ya da henüz tanınmıyorBirkaç 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

  1. 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.
  2. İ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.
  3. 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.
  4. 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.
  5. 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.
  6. 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ımUygulama kısıtı
Geocoding API, Routes API, Roads API gibi sunucu taraflı web servisleriIP adresleri
Maps JavaScript API, Maps Static API, Street View Static APIWeb siteleri (HTTP yönlendiren)
Maps SDK for Android, Places SDK for AndroidAndroid uygulamaları (paket adı ve SHA-1 parmak izi)
Maps SDK for iOS, Places SDK for iOSiOS uygulamaları (paket kimliği)
Maps Embed APIYalnı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.

GrupAylık ücretsiz kullanımÖrnek SKU
Essentials10.000 çağrıDynamic Maps, Geocoding, Static Maps, Time Zone
Pro5.000 çağrıElevation, Dynamic Street View, Nearby Search Pro
Enterprise1.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.

Bu yazıyı paylaşın

Kaynaklar

Bu sayfadaki bilgiler aşağıdaki kaynaklara dayanır. Ürün ve mevzuat değişebilir, kaynakları da kontrol edin.

SSS

Sık sorulan sorular

REQUEST_DENIED ile OVER_QUERY_LIMIT arasındaki fark nedir?

REQUEST_DENIED isteğin reddedildiğini gösterir ve nedeni anahtar, API ya da faturalama ayarlarındadır. OVER_QUERY_LIMIT kota ya da faturalama hesabı eksikliği gibi kullanım sınırlarına takılındığını gösterir. İkisinde de önce error_message alanı okunmalıdır.

Geocoding API çağrısında HTTP yönlendiren kısıtlı anahtar kullanılabilir mi?

Hayır. Google'ın SSS sayfasına göre web servislerinde HTTP yönlendiren kısıtlı anahtar kullanılırsa "API keys with referer restrictions cannot be used with this API" hatası alınır. Sunucu için IP adresi kısıtlı ayrı bir anahtar oluşturulur.

Anahtarı kısıtsız bırakmak güvenli mi?

Değil. Kısıtsız anahtar herhangi bir Maps Platform servisiyle kullanılabilir ve kötüye kullanımdan doğan ücretlerden anahtarın sahibi sorumludur. Hem uygulama kısıtı hem API kısıtı koyun.

API'yi etkinleştirdim ama hata sürüyor, ne yapmalıyım?

Google'ın belgesi, etkinleştirmeden sonra isteklerin çalışması için birkaç dakika beklemek gerekebileceğini belirtir. Beklemeye rağmen sürüyorsa anahtarın API kısıt listesinde ilgili API'nin olduğunu ve faturalamanın bağlı olduğunu kontrol edin.

İlgili sayfalar

Diğer yazılar

İletişim

Google ortamınızı birlikte yönetelim

Lisans, geçiş, güvenlik ve destek; Xen Bilişim ile tek muhatap.