Places UI Kit: Geliştiricilere özelleştirme ve kontrol imkanı sunan, kullanıma hazır bir kitaplıktır. Deneyin ve kullanıcı arayüzü kiti deneyiminizle ilgili görüşlerinizi paylaşın.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Hata mesajları

Bu sayfada, Maps JavaScript API tarafından döndürülebilecek hata mesajları açıklanmaktadır. Maps JavaScript API, JavaScript konsoluna hata ve uyarı mesajları yazar. Belirli hata koşulları da oluşabilir ve bu durum, filigranlı haritanın karartılmış şekilde gösterilmesine neden olur.

API Anahtarı ve Faturalandırma Hataları

Sorun giderme

Belirli durumlarda, "yalnızca geliştirme amaçlıdır" metniyle filigran eklenmiş karartılmış bir harita veya "negatif" Street View görüntüsü gösterilebilir. Bu davranış genellikle API anahtarı veya faturalandırmayla ilgili sorunları gösterir. Google Haritalar Platformu ürünlerini kullanmak için hesabınızda faturalandırma etkinleştirilmeli ve tüm istekler geçerli bir API anahtarı içermelidir. Hata mesajlarını bulma konusunda yardım için tarayıcınızdaki hataları kontrol etme bölümüne bakın.

Aşağıdaki akış, sorunu gidermenize yardımcı olacaktır.

API anahtarı kullanıyor musunuz?

Emin değilim. API anahtarı kullanıp kullanmadığımı nasıl kontrol edebilirim?

API anahtarı, Maps JavaScript API'yi yüklemek için kullanılan URL'de key parametresi olarak iletilir. API anahtarı kullanıp kullanmadığınızı kontrol etmek için birkaç seçenek aşağıda verilmiştir:

Google Haritalar Platformu API Checker Chrome uzantısını kullanın. Bu sayede, web sitenizin Google'ın lisanslı Maps API'lerini doğru şekilde uygulayıp uygulamadığını belirleyebilirsiniz.
Maps JavaScript API'yi yüklemek için bir kitaplık veya eklenti kullanıyorsanız bu kitaplığın ayarlarını kontrol edin ve API anahtarı seçeneğini arayın.
Tarayıcınızdaki hataları kontrol edin. Aşağıdaki mesajları görüyorsanız API anahtarınızı doğru şekilde kullanmıyorsunuz demektir:

Google Maps JavaScript API uyarısı: NoApiKeys
Google Maps JavaScript API hatası: MissingKeyMapError

Web geliştiricileri için:

Uygulamanızın kaynak koduna erişiminiz varsa Maps JavaScript API'yi yüklemek için kullanılan <script> etiketini bulun. Maps JavaScript API'yi yüklerken aşağıdaki kodda YOUR_API_KEY yerine API anahtarınızı kullanın.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Tarayıcıda web siteniz tarafından oluşturulan ağ trafiğini kontrol edin. Chrome'da bu durum, DevTools Ağ sekmesi kullanılarak görüntülenebilir. Web sitenizin yaptığı ağ isteklerini burada görürsünüz. Maps JavaScript API kullanılarak yapılan istekler maps/api/js yolu altında yer alır. Burada, isteklerin key parametresini kullanıp kullanmadığını onaylayabilirsiniz. Ağ sekmesini görüntülerken ağ trafiğinizi maps/api/js ile filtrelemeniz faydalı olabilir.

Hayır, API anahtarı kullanmıyorum.

API anahtarı almak için aşağıdaki düğmeyi tıklayın. Rehberli kurulum görmüyorsanız Google Haritalar Platformu'nu kullanmaya başlama sayfasındaki talimatların tamamını uygulayın.
Başlayın

Evet, API anahtarı kullanıyorum.

Mükemmel! Devam edelim ve projenize bir faturalandırma hesabının eklenip eklenmediğini kontrol edelim.

Projenize bir faturalandırma hesabı eklenmiş mi?

Emin değilim. Faturalandırma hesabının projeme bağlı olup olmadığını nasıl kontrol edebilirim?

Google Cloud Console'da Faturalandırma sayfasına gidin ve API anahtarınızın oluşturulduğu projeyi seçin. Anahtarın projeyle ilişkilendirildiğini onaylamak için:

Sol taraftaki çubukta Google Haritalar Platformu > Kimlik bilgileri bölümünden erişilebilen Kimlik bilgileri bölümüne gidin.
Web sitenizde kullandığınız API anahtarının listede yer aldığından emin olun. Bu durum söz konusu değilse farklı bir projeye geçip kimlik bilgilerini orada kontrol edin.
API anahtarınızın projesini bulamıyorsanız bu projeye erişiminizi kaybetmiş olabilirsiniz. Kuruluşunuzdaki diğer kullanıcılardan yardım isteyin. Orijinal proje bulunamıyorsa:
1. Yeni bir proje oluşturun. Bunu yapmak için proje listesinden Yeni Proje'yi veya Kaynak Yöneticisi sayfasından Proje Oluştur'u seçebilirsiniz.
2. Yeni bir API anahtarı oluşturma. Bu işlem Kimlik bilgileri sayfasında yapılabilir. Bu sayfada Kimlik bilgileri oluştur'u tıklayın ve ardından API anahtarı'nı seçin.

Cloud Console'da projenizi bulduktan sonra, sol taraftaki menüde Faturalandırma bölümüne giderek bir faturalandırma hesabının eklenip eklenmediğini kontrol edin.

Hayır, projeme bağlı bir faturalandırma hesabı yok.

Cloud Console'da Faturalandırmayı Etkinleştir sayfasına gidin ve projenize bir faturalandırma hesabı ekleyin. Daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.

Evet, projeme bir faturalandırma hesabı bağlı.

Mükemmel! Sağlanan ödeme yönteminin geçerli olduğundan emin olalım.

Sağlanan ödeme yöntemi artık geçerli değil mi (ör. süresi dolmuş bir kredi kartı)?

Cloud Console'da ödeme yöntemi ekleyebilir, kaldırabilir veya güncelleyebilirsiniz.

API'de aşılmış, kendiniz belirlediğiniz bir günlük sınır var mı?

API'lerinizden herhangi birinde günlük sınır belirlediyseniz (beklenmedik artışları önlemek için bu yaygın bir uygulamadır) günlük sınırınızı artırarak bu sorunu çözebilirsiniz.

Günlük sınırlarınızı kontrol etmek için Cloud Console'da API'ler ve Hizmetler Kontrol Paneli'ne gidin. Bu bölümde:

İstenirse bir proje seçin.
Listeden bir API seçin ve Kotalar sekmesini tıklayın.

API anahtarınızda IP adresi kısıtlaması var mı?

IP adresi kısıtlaması olan API anahtarları yalnızca sunucu tarafında kullanılmak üzere tasarlanmış web hizmetleriyle (ör. Geocoding API ve diğer Web Hizmeti API'leri) kullanılabilir. Bu web hizmetlerinin çoğunun Maps JavaScript API'de eşdeğer hizmetleri vardır (örneğin, Geocoding Hizmeti'ne bakın). Maps JavaScript API istemci tarafı hizmetlerini kullanmak için HTTP yönlendirenleri kısıtlamasıyla güvenli hale getirilebilecek ayrı bir API anahtarı oluşturmanız gerekir (API anahtarı alma, ekleme ve kısıtlama başlıklı makaleyi inceleyin).

Geliştiriciler ve Site Sahipleri İçin Maps JavaScript API Hata Kodları

Aşağıdaki tablolarda, Maps JavaScript API'nin döndürdüğü olası hata kodları, nedenlerinin açıklaması ve sorunu nasıl düzeltebileceğiniz listelenmektedir. Hata mesajlarını bulma konusunda yardım için tarayıcınızdaki hataları kontrol etme ile ilgili bölüme bakın.

Harita Yükleme Hataları

Maps JavaScript API'yi yüklerken bir hatayla karşılaşırsanız hata kodlarının açıklamalarını aşağıdaki tabloda bulabilirsiniz.

Hata Kodu Mesaj Açıklama

Hata Kodu	Mesaj	Açıklama
`NotLoadingAPIFromGoogleMapsError`	Haritalar JavaScript API'si doğrudan Google'ın sunucularından indirilmelidir.	Haritalar JavaScript API'sini yükleyen komut dosyası öğesi, sayfanıza doğru şekilde dahil edilmiyor. API'nin doğru şekilde çalışması için doğrudan https://maps.googleapis.com adresinden yüklenmesi gerekir. Maps JavaScript API'yi yükleme başlıklı makaleyi inceleyin.
`TOSViolationMapError`	Bu web sitesi, Google Maps API Hizmet Şartları'nı ihlal ediyor. Google Maps API, bu web sitesi için devre dışı bırakıldı.	Uygulamanız, Google Haritalar Platformu Hizmet Şartları'na uymadığı için engellendi. Bu işlem, birkaç e-posta bildirimi gönderildikten sonra gerçekleştirildi. Engellemeye itiraz etmek ve uygulamanızın incelenmesini sağlamak için lütfen bu formu doldurun. Birkaç iş günü içinde e-postayla yanıt alırsınız. Lütfen bu hatayı çözmek için API anahtarınızı veya istemci kimliği kimlik bilgilerinizi kullanın. API anahtarları ve istemci kimlikleri kılavuzuna bakın.
`UnauthorizedURLForClientIdMapError`	Bu URL, sağlanan Google Haritalar istemci kimliğini kullanma yetkisine sahip değil.	Komut dosyası yüklemesine dahil edilen istemci kimliği geçersiz, süresi dolmuş veya Maps JavaScript API'yi yükleyen geçerli adres, yetkili URL'ler listesine eklenmemiş. Yetkili URL'leri kaydetme başlıklı makaleyi inceleyin.

NotLoadingAPIFromGoogleMapsError

Haritalar JavaScript API'si doğrudan Google'ın sunucularından indirilmelidir.

Haritalar JavaScript API'sini yükleyen komut dosyası öğesi, sayfanıza doğru şekilde dahil edilmiyor. API'nin doğru şekilde çalışması için doğrudan https://maps.googleapis.com adresinden yüklenmesi gerekir.

Maps JavaScript API'yi yükleme başlıklı makaleyi inceleyin.

TOSViolationMapError

Bu web sitesi, Google Maps API Hizmet Şartları'nı ihlal ediyor. Google Maps API, bu web sitesi için devre dışı bırakıldı.

Uygulamanız, Google Haritalar Platformu Hizmet Şartları'na uymadığı için engellendi. Bu işlem, birkaç e-posta bildirimi gönderildikten sonra gerçekleştirildi. Engellemeye itiraz etmek ve uygulamanızın incelenmesini sağlamak için lütfen bu formu doldurun. Birkaç iş günü içinde e-postayla yanıt alırsınız.

Lütfen bu hatayı çözmek için API anahtarınızı veya istemci kimliği kimlik bilgilerinizi kullanın. API anahtarları ve istemci kimlikleri kılavuzuna bakın.

UnauthorizedURLForClientIdMapError

Bu URL, sağlanan Google Haritalar istemci kimliğini kullanma yetkisine sahip değil.

Komut dosyası yüklemesine dahil edilen istemci kimliği geçersiz, süresi dolmuş veya Maps JavaScript API'yi yükleyen geçerli adres, yetkili URL'ler listesine eklenmemiş.

Yetkili URL'leri kaydetme başlıklı makaleyi inceleyin.

Maps JavaScript API hata kodları

Chrome JavaScript Konsolu, Firefox Web Konsolu veya tarayıcılarınızdaki diğer eşdeğer araçlarda bir hata görürseniz hata kodlarının açıklamalarını bulmak için lütfen aşağıdaki tabloya bakın.

Maps JavaScript API hem hataları hem de uyarıları döndürür. Hata, Maps JavaScript API'si yüklenirken oluşan ciddi bir sorunu gösterir. Sayfanız API'yi doğru şekilde yükleyemez ve API bu sayfada çalışmaz. Uyarı, Maps JavaScript API'nin yüklenmesiyle ilgili ek bir mesajdır. Uyarıda, hatanın olası nedenleri açıklanır veya Maps JavaScript API'yi yükleyen kodunuzdaki olası sorunlar önerilir. Herhangi bir hata olmadan yalnızca uyarı alırsanız API bu sayfada doğru şekilde çalışır. Ancak bu olası sorunları da düzeltmenizi öneririz.

Geliştirici Hata Kodu	Tür	Açıklama
`ApiNotActivatedMapError`	Hata	Maps JavaScript API, API projenizde etkinleştirilmemiş. Google Cloud Console'daki API'ler bölümünde Maps JavaScript API'yi etkinleştirmeniz gerekebilir. Projenizde Maps JavaScript API'yi etkinleştirmek için aşağıdaki düğmeyi tıklayın. Nasıl yapılacağını öğrenin
`ApiTargetBlockedMapError`	Hata	Bu API anahtarının bu hizmeti veya API'yi kullanma yetkisi yok. Kullanmanız gereken tüm API'lerin ve hizmetlerin, etkin API'ler listesinde doğru şekilde belirtildiğinden emin olmak için lütfen Google Cloud Console'da API anahtarınızın API kısıtlamaları ayarlarını kontrol edin. Cloud Console'da API anahtarları başlıklı makaleyi inceleyin. Daha fazla bilgi için API güvenliğiyle ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.
`DeletedApiProjectMapError`	Hata	API projeniz Cloud Console'dan silinmiş olabilir. Lütfen JavaScript API yükleyicisinde bulunan API anahtarını oluşturduğunuz projeyi kontrol edin. Cloud Console'da yeni bir API projesi oluşturabilir ve yeni bir anahtar alabilirsiniz. Yeni bir proje oluşturmak ve proje için API anahtarı almak üzere aşağıdaki düğmeyi tıklayın. Nasıl yapılacağını öğrenin
`ClientBillingNotEnabledMapError`	Hata	Projenizde faturalandırmayı etkinleştirmediniz. Bu istemci kimliğiyle ilişkili Google Cloud projesinde faturalandırmayı buradan etkinleştirmeniz gerekir.
`BillingNotEnabledMapError`	Hata	Projenizde faturalandırmayı etkinleştirmediğiniz için bu hata oluşuyor. Google Cloud projesinde faturalandırmayı buradan etkinleştirmeniz gerekir. Daha fazla bilgi
`ExpiredKeyMapError`	Hata	API'yi yükleyen komut dosyası öğesinde bulunan API anahtarının süresi dolmuş veya sistem tarafından tanınmıyor. Sistem tarafından tanınmadan önce anahtarı kullanmaya çalışırsanız yeni bir API anahtarı oluşturduktan sonra bu hatayı alabilirsiniz. Birkaç dakika bekleyip tekrar deneyin veya Cloud Console'da yeni bir API anahtarı oluşturmanız gerekebilir. API anahtarı almak için aşağıdaki düğmeyi tıklayın. Başlayın
`InvalidAppCheckTokenMapError`	Hata	Sağlanan Uygulama Kontrolü jetonu geçersiz veya jetonun süresi dolmuş. Bu hata yalnızca Uygulama Kontrolü doğrulaması kullanılıyorsa oluşabilir. Uygulama Kontrolü doğrulama kılavuzunu inceleyin.
`InvalidClientIdMapError`	Hata	Kimlik doğrulama güvenliğini ve güvenilirliğini artırmak için Maps Platform istemci kimlikleri 26 Mayıs 2025'ten itibaren kullanımdan kaldırılmıştır ve 31 Mayıs 2026'dan sonra kullanılamayacaktır. Google Haritalar API hizmet trafiğinizin kimliğini doğrulamak için istemci kimliği yerine API anahtarı kimlik bilgilerini kullanmanız gerekir. Daha fazla bilgi için İstemci Kimliği Geçiş Rehberi'ni inceleyin. İstemci kimliğini geçici olarak geri yüklemek için kılavuzdaki adımları uygulayın.
`InvalidKeyMapError`	Hata	API'yi yükleyen komut dosyası öğesinde bulunan API anahtarı bulunamadı. Lütfen doğru API anahtarını kullandığınızdan emin olun. Cloud Console'da yeni bir API anahtarı oluşturabilirsiniz. API anahtarı almak için aşağıdaki düğmeyi tıklayın. Başlayın
`MalformedCredentialsMapError`	Hata	Uygulamanız desteklenmeyen bir URI şeması kullanıyor. Uygulamanın, RFC 3986'da tanımlandığı şekilde geçerli bir URI biçimi kullandığını doğrulayın.
`MissingKeyMapError`	Hata	API'yi yükleyen komut dosyası öğesinde gerekli kimlik doğrulama parametresi eksik. Maps JavaScript API'yi kullanıyorsanız geçerli bir API anahtarı içeren bir `key` parametresi kullanmanız gerekir. Daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin. İstemci kimliği kullanıyorsanız istemci kimliğinizle birlikte bir `client` parametresi veya geçerli bir API anahtarıyla birlikte bir `key` parametresi kullanmanız gerekir. Daha fazla bilgi için API anahtarları ve istemci kimlikleri kılavuzuna bakın. Web sitesinin sahibi DEĞİLSENİZ bu hatayı düzeltmek için yapabileceğiniz bir işlem yoktur. Ancak mümkünse site sahibini bilgilendirmeniz önerilir.
`ProjectDeniedMapError`	Hata	İsteğiniz tamamlanmadı. Hatayla ilgili daha fazla ayrıntıyı Cloud Console'da bulabilirsiniz. Cloud Console bölümüne bakın.
`RefererDeniedMapError`	Hata	Başvurunuz, Google Haritalar Platformu Hizmet Şartları'na uymamanız nedeniyle birkaç e-posta bildirimi gönderildikten sonra engellendi. Engellemeye itiraz etmek ve uygulamanızın incelenmesini sağlamak için lütfen bu formu doldurun. Birkaç iş günü içinde e-postayla yanıt alacaksınız.
`RefererNotAllowedMapError`	Hata	Haritalar JavaScript API'sini yükleyen mevcut URL, izin verilen yönlendirenler listesine eklenmemiştir. Lütfen Cloud Console'da API anahtarınızın yönlendiren ayarlarını kontrol edin. Maps JavaScript API ve API anahtarı alma başlıklı makalelere göz atın.
`OverQuotaMapError`	Hata	İstek sayısı, Maps JavaScript API'nin kullanım sınırlarını aştı. Uygulamanızın istekleri, bir sonraki günlük kota sıfırlamasında tekrar çalışır. Web sitesinin sahibi değilseniz bu hatayı düzeltmek için yapabileceğiniz bir şey yoktur. Ancak mümkünse site sahibini bilgilendirmek isteyebilirsiniz. Daha fazla bilgi için kullanım sınırları kılavuzunu inceleyin. Sayfada, daha yüksek kullanım sınırlarına nasıl ulaşabileceğiniz de açıklanmaktadır.
`ApiProjectMapError`	Hata	Sağlanan API anahtarı veya ilişkili olduğu API projesi çözümlenemedi. Bu hata geçici olabilir. Bu hata mesajı devam ederse yeni bir API anahtarı almanız veya yeni bir API projesi oluşturmanız gerekebilir. Daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.
`ClientIdLooksLikeCryptoKey`	Uyarı	`client` parametresinde bir şifreleme anahtarı sağlamış olabilirsiniz. Lütfen istemci kimliğinizi `client` parametresi olarak belirtin. Maps JavaScript API için şifreleme anahtarınızı kullanmanız gerekmez. İstemci kimlikleri ile ilgili kılavuza bakın.
`ClientIdLooksLikeKey`	Uyarı	`client` parametresinde bir API anahtarı sağlamış olabilirsiniz. Lütfen istemci kimliğinizi `client` parametresi olarak belirtin veya `client` parametresi yerine geçerli bir API anahtarı içeren `key` parametresi kullanın. API anahtarları ve istemci kimlikleri kılavuzuna bakın.
`InvalidChannel`	Uyarı	Geçersiz bir `channel` parametresi girmiş olabilirsiniz. Kanal, nokta (.), alt çizgi (_) ve kısa çizgi (-) içerebilen bir ASCII alfanümerik dize olmalıdır. Lütfen geçerli bir `channel` parametresi belirttiğinizden emin olun. Raporlama \| Google Haritalar Platformu başlıklı makaleyi inceleyin.
`InvalidClientId`	Uyarı	`client` parametresi doğru bir istemci kimliği içermiyor. İstemci kimliği "gme-" ile başlamalıdır. API anahtarları ve istemci kimlikleri kılavuzuna bakın.
`InvalidKey`	Uyarı	API'yi yükleyen komut dosyası öğesinde bulunan API anahtarı doğru görünmüyor. Lütfen doğru bir API anahtarı kullandığınızdan emin olun. Cloud Console'da yeni bir API anahtarı oluşturabilirsiniz. API anahtarı almak için aşağıdaki düğmeyi tıklayın. Başlayın
`InvalidVersion`	Uyarı	Komut dosyası öğenizde yanlış bir sürüm numarası sağlamış olabilirsiniz. Lütfen doğru sürüm numarasını kullandığınızdan emin olun. Sürüm oluşturma \| Google Maps JavaScript API başlıklı makaleyi inceleyin.
`KeyLooksLikeClientId`	Uyarı	`key` parametresi olarak bir istemci kimliği sağlamış olabilirsiniz. Lütfen istemci kimliğinizi `key` parametresi yerine `client` parametresi olarak belirtin veya geçerli bir API anahtarıyla `key` parametresi kullanın. API anahtarları ve istemci kimlikleri ile ilgili kılavuza bakın.
`KeyLooksLikeCryptoKey`	Uyarı	Şifreleme anahtarını veya imzalama gizli anahtarını `key` parametresi olarak sağlamış olabilirsiniz. Lütfen istemci kimliğinizi `client` parametresi olarak belirtin ve `key` parametresini komut dosyası öğenizden kaldırın. Maps JavaScript API için şifreleme anahtarı gerekli değildir. Alternatif olarak, Cloud Console'da bir API anahtarı alabilir ve `key` parametresini kullanabilirsiniz. API'yi yüklerken istemci kimliği belirtme ile ilgili kılavuza bakın.
`KeyLooksLikeProjectNumber`	Uyarı	`key` parametresi olarak bir proje numarası sağlamış olabilirsiniz. Lütfen doğru bir API anahtarı kullandığınızdan emin olun. Cloud Console'da yeni bir API anahtarı oluşturabilirsiniz. API anahtarı almayı öğrenin.
`NoApiKeys`	Uyarı	API'yi yükleyen komut dosyası öğesinde API anahtarı yok. Lütfen `key` parametresi olarak geçerli bir API anahtarı eklediğinizden emin olun. Cloud Console'da yeni bir API anahtarı oluşturabilirsiniz. API anahtarı almak için aşağıdaki düğmeyi tıklayarak başlayın. Başlayın Maps JavaScript API'yi desteği sonlandırılmış v2 yolundan yüklüyorsanız `key` parametresini belirtmiş olsanız bile `NoApiKeys` uyarısını alırsınız. Lütfen v2'den v3'e yükseltme kılavuzunu inceleyin ve uygulamanızı Maps JavaScript API v3'e taşıyın.
`RetiredVersion`	Uyarı	Komut dosyası öğenizde kullanımdan kaldırılmış bir sürüm kullanmış olabilirsiniz. Uygulamanızı mevcut sürümlerden birini kullanacak şekilde güncelleyin. Sürüm oluşturma \| Google Maps JavaScript API başlıklı makaleyi inceleyin.
`SensorNotRequired`	Uyarı	`sensor` parametresi artık Maps JavaScript API için gerekli değildir. Bu durum, Haritalar JavaScript API'sinin doğru şekilde çalışmasını engellemez ancak `sensor` parametresini komut dosyası öğesinden kaldırmanızı öneririz.
`SignatureNotRequired`	Uyarı	`signature` parametresi, Maps JavaScript API için gerekli değildir. Bu durum, Maps JavaScript API'nin düzgün çalışmasını engellemez ancak güvenlik risklerine yol açabilir. Lütfen bunu komut dosyası öğenizden kaldırın.
`SignedInNotSupported`	Uyarı	`signed_in` parametresinin desteği sonlandırıldı ve kullandığınız Maps JavaScript API sürümünde desteklenmiyor. Bu durum, Maps JavaScript API'nin çalışmasını engellemez ancak oturum açma özelliklerini kullanıyorsanız uygulamanızın davranışı değişebilir.
`UrlAuthenticationCommonError`	Hata	Bu sayfadaki diğer kategorilere uymayan bir hata oluştu. Bu durum geçici bir sorundan kaynaklanıyor olabilir. Lütfen kısa bir süre sonra isteği tekrar deneyin. Bu işlem sorunu çözmezse lütfen isteğin doğru biçimde olduğundan emin olmak için geliştirici kılavuzunu inceleyin.

Tarayıcınızdaki hataları kontrol etme

Maps JavaScript API, hata mesajlarını window.console konumuna yazar. Bu bölümde, Google Chrome'da window.console çıkışını nasıl kontrol edebileceğiniz açıklanmaktadır. Başka bir tarayıcı kullanıyorsanız lütfen tarayıcınızın geliştirici belgelerini inceleyin. Referans olarak, diğer bazı tarayıcılarda window.console çıkışını kontrol etmek için kullanabileceğiniz araçların listesi aşağıda verilmiştir.

Firefox için Web Konsolu.
Android için uzaktan hata ayıklama.
iOS için Web Inspector.

Chrome'da window.console çıkışını aşağıdaki şekilde kontrol etmek için JavaScript Konsolu'nu kullanabilirsiniz.

Geliştirici Araçları'nı açmak için menü simgesi > Diğer Araçlar > Geliştirici Araçları'nı seçin.
JavaScript Konsolu'nu açmak için klavyenizdeki ESC tuşuna basın. ESC tuşu, JavaScript Konsolu'nu açıp kapatır. Konsolu kapatırsanız açmak için ESC tuşuna tekrar basın.

Maps JavaScript API'si yüklenirken hata veya uyarı oluşursa bunlar konsolda bir veya daha fazla satır olarak görünür. Hata veya uyarı mesajları aşağıdaki biçimde olur:

Google Maps API error: [ERROR CODE] [Link to API document]
veya
Google Maps API warning: [ERROR CODE] [Link to API document]

Hata mesajındaki hata kodunu bulmak için yukarıdaki hata kodları tablosuna bakabilirsiniz. Hata mesajıyla ilgili ayrıntıları, mesajda bağlantısı verilen API dokümanında da bulabilirsiniz.

Not: Kimlik doğrulama hatalarını programatik olarak dinleyebilirsiniz.

Desteklenmeyen tarayıcıları işleme

Kullandığınız tarayıcı sürümünün şu anda Haritalar JavaScript API'si tarafından desteklendiğinden emin olun.

WebView'da çalışan yerel bir Windows uygulaması geliştiriyorsanız Edge tabanlı WebView2'yi kullandığınızdan emin olun. Internet Explorer'a dayalı önceki WebView sürümleri artık desteklenmiyor.

Kodunuz hâlâ çalışmıyorsa

Brendan Kenny ve Mano Marks, harita kodunuzu kullanmaya başlamanıza yardımcı olmak için bu videoda bazı yaygın hatalara ve bunları nasıl düzelteceğinize dikkat çekiyor.

Yazım hatası olup olmadığını kontrol edin. JavaScript'in büyük/küçük harfe duyarlı bir dil olduğunu unutmayın.
Temel bilgileri kontrol edin: En yaygın sorunlardan bazıları ilk harita oluşturma aşamasında ortaya çıkar. Örneğin:
- Harita seçeneklerinizde zoom ve center özelliklerini belirttiğinizi onaylayın.
- Haritanın ekranda görüneceği bir div öğesi tanımladığınızdan emin olun.
- Harita için div öğesinin bir yüksekliği olduğundan emin olun. Varsayılan olarak div öğeleri 0 yüksekliğinde oluşturulur ve bu nedenle görünmez.
Referans uygulaması için örneklerimize göz atın. Referans uygulaması için örneklerimize göz atın.
Sorunları belirlemek için Chrome Geliştirici Araçları'nda bulunan JavaScript hata ayıklayıcı gibi bir araç kullanın. Öncelikle JavaScript konsolunda hata olup olmadığına bakın.
Sorularınızı Stack Overflow'da yayınlayın. İyi sorular sormayla ilgili yönergeleri Destek sayfasında bulabilirsiniz.