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, koyulaştırılmış filigranlı bir haritanın görüntülenmesine 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 olduğunu gösterir. Google Maps Platform ürünlerini kullanmak için hesabınızda faturalandırmanın etkinleştirilmesi ve tüm isteklerin geçerli bir API anahtarı içermesi gerekir. Hata mesajlarını bulma konusunda yardım için tarayıcınızdaki hataları kontrol etme ile ilgili bölüme 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çeneği aşağıda bulabilirsiniz:

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 bulun.
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ı girin.
```
  <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, DevTools Ağ sekmesi kullanılarak görüntülenebilir. Web sitenizin yaptığı ağ isteklerini burada görebilirsiniz. Maps JavaScript API kullanılarak yapılan istekler maps/api/js yolunda olur. Burada, isteklerin key parametresini kullanıp kullanmadığını onaylayabilirsiniz. Ağ sekmesini görüntülerken ağ trafiğinizi maps/api/js ile filtrelemek yararlı 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! Şimdi projenize bir faturalandırma hesabı eklenip eklenmediğini kontrol edelim.

Projenize bağlı bir faturalandırma hesabı var mı?

Emin değilim. Projeme bir faturalandırma hesabı eklenip eklenmediğini 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şkili olduğunu 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. Durum böyle değilse farklı bir projeye geçip kimlik bilgilerini 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 şunları yapmanız gerekir:
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.

Projenizi Cloud Console'da bulduktan sonra, sol taraftaki menüden Faturalandırma bölümüne giderek bir faturalandırma hesabının ekli olup olmadığını 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ı ekli.

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 kendi belirlediğiniz günlük sınır aşıldı 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ı Cloud Console'daki API'ler ve Hizmetler Kontrol Paneli'ne giderek kontrol edebilirsiniz. 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 adresleri 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ğu, Maps JavaScript API'de eşdeğer hizmetlere sahiptir (ö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 tarafından döndürülen olası hata kodları, nedenleri ve sorunu nasıl düzeltebileceğiniz açıklanmaktadır. 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`	Maps JavaScript API doğrudan Google'ın sunucularından indirilmelidir.	Maps JavaScript API'yi yükleyen komut dosyası öğesi, sayfanıza doğru şekilde eklenmiyor. 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, size gönderilen birkaç e-posta bildiriminin ardından gerçekleştirildi. Engellemeye itiraz etmek ve uygulamanızın incelenmesini sağlamak için Google Haritalar Platformu Hizmet Şartları itiraz formunu doldurun. Birkaç iş günü içinde e-postayla yanıt alırsınız. Bu hatayı çözmek için lütfen API anahtarınızı veya istemci kimliği kimlik bilgilerinizi kullanın. API anahtarları ve istemci kimlikleri kılavuzuna bakın.
`UnauthorizedURLForClientIdMapError`	Bu URL'nin, sağlanan Google Haritalar istemci kimliğini kullanma yetkisi yok.	Komut dosyası yüklemesine dahil edilen istemci kimliği geçersiz veya süresi dolmuş ya da Maps JavaScript API'yi yükleyen mevcut adres, yetkili URL'ler listesine eklenmemiş. Yetkili URL'leri kaydetme başlıklı makaleyi inceleyin.

NotLoadingAPIFromGoogleMapsError

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

Maps JavaScript API'yi yükleyen komut dosyası öğesi, sayfanıza doğru şekilde eklenmiyor. 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, size gönderilen birkaç e-posta bildiriminin ardından gerçekleştirildi. Engellemeye itiraz etmek ve uygulamanızın incelenmesini sağlamak için Google Haritalar Platformu Hizmet Şartları itiraz formunu doldurun. Birkaç iş günü içinde e-postayla yanıt alırsınız.

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

UnauthorizedURLForClientIdMapError

Bu URL'nin, sağlanan Google Haritalar istemci kimliğini kullanma yetkisi yok.

Komut dosyası yüklemesine dahil edilen istemci kimliği geçersiz veya süresi dolmuş ya da Maps JavaScript API'yi yükleyen mevcut 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ı aşağıdaki tabloda bulabilirsiniz.

Maps JavaScript API hem hataları hem de uyarıları döndürür. Hata, Maps JavaScript API yüklenirken ciddi bir sorun oluştuğunu 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, bir hatanın olası nedenleri açıklanır veya Maps JavaScript API'yi yükleyen kodunuzdaki olası sorunlar belirtilir. 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ştir. Google Cloud Console'da API'ler bölümünden Maps JavaScript API'yi etkinleştirmeniz gerekebilir. Projeniz için Maps JavaScript API'yi etkinleştirmek üzere 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ı bölümüne bakın. 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ükleyicide 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ı etkinleştirmeniz gerekir.
`BillingNotEnabledMapError`	Hata	Projenizde faturalandırmayı etkinleştirmediğiniz için bu hata oluşuyor. Google Cloud projesinde faturalandırmayı etkinleştirmeniz gerekir. Daha fazla bilgi
`ExpiredKeyMapError`	Hata	API'yi yükleyen komut dosyası öğesinde bulunan API anahtarının süresi dolmuş veya anahtar sistem tarafından tanınmıyor. Yeni bir API anahtarı oluşturduktan sonra, anahtarı sistem tarafından tanınmadan önce kullanmaya çalışırsanız 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 ortaya çıkabilir. Uygulama Kontrolü doğrulaması ile ilgili kılavuzu 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 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
`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 `client` parametresini veya geçerli bir API anahtarıyla birlikte `key` parametresini kullanmanız gerekir. Daha fazla bilgi için API anahtarları ve istemci kimlikleri kılavuzuna bakın. Web sitesinin sahibi değilseniz bu hatayı düzeltmek için yapabileceğiniz bir şey yoktur. Ancak mümkünse site sahibini bilgilendirmeniz önerilir.
`ProjectDeniedMapError`	Hata	İsteğiniz tamamlanmadı. Hata hakkında daha fazla bilgiyi Cloud Console'da bulabilirsiniz. Cloud Console'a bakın.
`RefererDeniedMapError`	Hata	Uygulamanız, Google Haritalar Platformu Hizmet Şartları'na uymadığı için engellendi. Bu işlem, size gönderilen birkaç e-posta bildiriminin ardından gerçekleştirildi. Engellemeye itiraz etmek ve uygulamanızın incelenmesini sağlamak için Google Haritalar Platformu Hizmet Şartları itiraz formunu doldurun. Birkaç iş günü içinde e-postayla yanıt alırsınız.
`RefererNotAllowedMapError`	Hata	Maps JavaScript API'yi yükleyen mevcut URL, izin verilen yönlendirenler listesine eklenmedi. Lütfen Cloud Console'da API anahtarınızın yönlendiren ayarlarını kontrol edin. Maps JavaScript API'ye ve API anahtarı alma bölümüne bakı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ılavuzuna bakın. Bu 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 kılavuzuna 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 sayfasına bakın.
`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ı öğesindeki 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ı belirtmiş olabilirsiniz. Lütfen doğru bir sürüm numarası kullandığınızdan emin olun. Sürüm oluşturma \| Google Maps JavaScript API başlıklı makaleyi inceleyin.
`KeyLooksLikeClientId`	Uyarı	İstemci kimliğini `key` parametresi olarak sağlamış olabilirsiniz. Lütfen istemci kimliğinizi `key` parametresi yerine `client` parametresi olarak belirtin veya geçerli bir API anahtarı içeren `key` parametresi kullanın. API anahtarları ve istemci kimlikleri kılavuzuna 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 komut dosyası öğenizden `key` parametresini 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 kılavuzuna 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 kullanımdan kaldırılan 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, Maps JavaScript API'nin düzgün ç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 bu özelliği 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 isteğin doğru biçimde olduğundan emin olmak için lütfen 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 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 Denetçisi.

Chrome'da JavaScript Konsolu'nu kullanarak window.console çıkışını aşağıdaki gibi kontrol edebilirsiniz.

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 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çimdedir:

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: Programatik olarak kimlik doğrulama hatalarını dinleyebilirsiniz.

Desteklenmeyen tarayıcıları işleme

Kullandığınız tarayıcı sürümünün Maps JavaScript API tarafından desteklendiğinden emin olun.

WebView'da çalışan bir Windows masaüstü uygulaması geliştiriyorsanız Edge tabanlı WebView2 kullandığınızdan emin olun. Internet Explorer'ı temel alan önceki WebView sürümleri artık desteklenmemektedir.

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

Brendan Kenny ve Mano Marks, harita kodunuzu çalışır duruma getirmenize yardımcı olmak için bu videoda bazı yaygın hataları ve bunların nasıl düzeltileceğini açıklıyor.

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 sırası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 uygulama için örneklerimizi inceleyin.
Sorunları belirlemenize yardımcı olması için Chrome Geliştirici Araçları'nda bulunan gibi bir JavaScript hata ayıklayıcısı 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.