Hata mesajları

Gerçek bir kişiden yardım almak mı istiyorsunuz?
Google Haritalar Platformu Destek sayfasına gidin.
Bu hata mesajları sayfası yalnızca referans amaçlıdır. Bu araç, Maps JavaScript API hatalarını kendi başınıza gidermenize yardımcı olmak için tasarlanmıştır. Bu sayfadan geri bildirim göndererek bir kullanıcıdan yardım istemeye çalışırsanız size yardımcı olabilecek birine ulaşamazsınız. Ancak bu sayfadaki içeriklerle ilgili bir sorunla karşılaşırsanız lütfen geri bildirim bağlantısını kullanarak bize bildirin. Teşekkürler!

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. Bazı hata koşulları da oluşabilir ve bu koşullar, karartılmış filigranlı bir haritanın gösterilmesine neden olur.

Web sitesinin sahibi DEĞİLSENİZ bu hataları düzeltmek için yapabileceğiniz herhangi bir işlem yoktur. Ancak mümkünse site sahibini bilgilendirmek isteyebilirsiniz.

API anahtarı ve faturalandırma hataları

Sorun giderme

Belirli durumlarda, "yalnızca geliştirme amaçları için" metniyle filigranlanmış, karartılmış bir harita veya "negatif" Street View görüntüsü gösterilebilir. Bu davranış genellikle API anahtarı veya faturalandırmayla ilgili sorunlara işaret eder. 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ı mı kullanıyorsunuz?

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

Maps JavaScript API'yi yüklemek için kullanılan URL'de key parametresi olarak bir API anahtarı iletilir. API anahtarı kullanıp kullanmadığınızı kontrol etmek için aşağıdaki seçeneklerden yararlanabilirsiniz:

• Google Haritalar Platformu API Checker Chrome uzantısını kullanın. Bu sayede, web sitenizin Google'ın lisanslı Haritalar 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ıyorsunuzdur:
• 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. Burada web siteniz tarafından yapılan ağ isteklerini 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 başlıklı makaledeki tüm talimatları 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:

1. Sol kenar çubuğundaki Google Haritalar Platformu > Kimlik Bilgileri bölümünden erişilebilen Kimlik Bilgileri bölümüne gidin.
2. Web sitenizde şu anda kullandığınız API anahtarının listelendiğinden emin olun. Bu durum söz konusu değilse farklı bir projeye geçin ve kimlik bilgilerini orada kontrol edin.
3. 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. Bu işlem, proje listesinden Yeni Proje'yi veya Kaynak Yöneticisi sayfasından Proje Oluştur'u seçerek yapılabilir.
   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 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, projemde faturalandırma hesabı ekli değil.

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, projemde bir faturalandırma hesabı var.

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

Belirtilen ödeme yöntemi artık geçerli değil mi (örneğin, kredi kartının süresi dolmuş)?

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

API'de aşılmış bir günlük sınır var mı?

Beklenmedik artışları önlemek için API'lerinizden herhangi birinde günlük sınır belirlediyseniz 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:

1. İstenirse bir proje seçin.
2. Listeden bir API seçip 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, Coğrafi Kodlama Hizmeti'ne bakın). Maps JavaScript API istemci tarafı hizmetlerini kullanmak için HTTP yönlendirenleri kısıtlamasıyla güvenli hale getirilebilen ayrı bir API anahtarı oluşturmanız gerekir (bkz. API anahtarı alma, ekleme ve kısıtlama).

Geliştiriciler ve site sahipleri için Maps JavaScript API hata kodları

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

Harita Yüklenirken Hata Oluştu

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
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 dahil edilmiyor. API'nin doğru ç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 sitesinin Google Maps API Hizmet Şartları'nı ihlal ettiği anlaşılıyor. Bu web sitesi için Google Maps API devre dışı bırakıldı.	Uygulamanız, Google Haritalar Platformu Hizmet Şartları'na uymaması 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-posta yoluyla yanıt alırsınız. Google Haritalar Platformu Premium Plan lisansınız varsa lütfen bu hatayı çözmek için Google Haritalar Platformu Premium Plan kimlik bilgilerinizi kullanın. Premium planı kimlik doğrulaması ile ilgili kılavuza bakın.
UnauthorizedURLForClientIdMapError	Bu URL'nin, sağlanan Google Haritalar istemci kimliğini kullanma yetkisi yok.	Komut dosyası yüklemesine dahil edilen Premium Plan veya Maps API'leri için İş istemci kimliği geçersiz, 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 bulursanız 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ükleyemiyor ve API bu sayfada çalışmıyor. Uyarı, Maps JavaScript API'nin yüklenmesiyle ilgili ek bir mesajdır. Uyarı, hatanın olası nedenlerini açıklar veya Maps JavaScript API'yi yükleyen kodunuzdaki olası sorunları önerir. Yalnızca uyarı alırsanız ve hata almazsanız API, söz konusu 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ılır?
ApiTargetBlockedMapError	Hata	Bu API anahtarının bu hizmeti veya API'yi kullanma yetkisi yok. Kullanmanız gereken tüm API'lerin ve hizmetlerin etkinleştirilmiş 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'daki API anahtarları başlıklı makaleyi inceleyin. Daha fazla bilgi için API güvenliğiyle ilgili en iyi uygulamalar konusuna bakın.
DeletedApiProjectMapError	Hata	API projeniz Cloud Console'dan silinmiş olabilir. Lütfen JavaScript API yükleyicisinde yer alan 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ılır?
ClientBillingNotEnabledMapError	Hata	Projenizde faturalandırmayı etkinleştirmemişsinizdir. Bu müşteri 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ı öğesine dahil edilen 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 App Check doğrulaması kullanılıyorsa oluşabilir. App Check doğrulama kılavuzuna bakın.
InvalidClientIdMapError	Hata	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. Daha fazla bilgi için İstemci Kimliği Geçiş Rehberi'ni inceleyin. Kılavuzdaki adımları uygulayarak müşteri kimliğini geçici olarak geri yükleyin.
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ızda desteklenmeyen bir URI şeması kullanılıyor. Uygulamanın, RFC 3986'da tanımlanan ş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. Standart Maps JavaScript API'yi kullanıyorsanız geçerli bir API anahtarıyla key parametresini kullanmanız gerekir. Daha fazla bilgi için Google Haritalar Platformu'nu Kullanmaya Başlama başlıklı makaleyi inceleyin. Premium Plan müşterisiyseniz 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 bilgilendirmek isteyebilirsiniz.
ProjectDeniedMapError	Hata	İsteğiniz tamamlanmadı. Hatayla ilgili daha fazla ayrıntıyı Cloud Console'da bulabilirsiniz. Cloud Console'u inceleyin.
RefererDeniedMapError	Hata	Uygulamanız, Google Haritalar Platformu Hizmet Şartları'na uymaması 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-posta yoluyla yanıt alırsınız.
RefererNotAllowedMapError	Hata	Maps JavaScript API'yi 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ışmaya başlar. Web sitesinin sahibi DEĞİLSENİZ bu hatayı düzeltmek için yapabileceğiniz bir işlem yoktur. Ancak mümkünse site sahibini bilgilendirebilirsiniz. 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. Premium Plan veya Maps API'leri için İş lisansınız varsa lütfen istemci kimliğinizi client parametresi olarak belirtin. Maps JavaScript API için şifreleme anahtarınızı kullanmanız gerekmez. Premium Plan ve Maps API'leri için İş müşterilerinin istemci kimlikleri ile ilgili kılavuza bakın.
ClientIdLooksLikeKey	Uyarı	client parametresinde bir API anahtarı sağlamış olabilirsiniz. Premium Plan veya Maps API'leri için İş lisansınız varsa lütfen istemci kimliğinizi client parametresi olarak belirtin. Google Haritalar Platformu Premium Planı'nız varsa client parametresini veya key parametresini kullanabilirsiniz. Lisansınız yoksa client parametresi yerine key parametresini kullanmanız gerekir. Premium planı kimlik doğrulaması ile ilgili kılavuza göz atın.
InvalidChannel	Uyarı	Geçersiz bir channel parametresi sağlamış olabilirsiniz. Kanal, nokta (.), alt çizgi (_) ve tire (-) 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 Premium Planı başlıklı makaleyi inceleyin.
InvalidClientId	Uyarı	client parametresi doğru bir istemci kimliği içermiyor gibi görünüyor. İstemci kimliği "gme-" ile başlamalıdır. Premium planı kimlik doğrulaması ile ilgili kılavuza göz atın.
InvalidKey	Uyarı	API'yi yükleyen komut dosyası öğesine dahil edilen 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ı	Senaryo öğenizde yanlış bir sürüm numarası sağlamış olabilirsiniz. Lütfen doğru sürüm numarasını kullandığınızdan emin olun. Versioning | Google Maps JavaScript API başlıklı makaleyi inceleyin.
KeyLooksLikeClientId	Uyarı	key parametresi olarak bir istemci kimliği sağlamış olabilirsiniz. Premium Plan veya Maps APIs for Work lisansınız varsa lütfen istemci kimliğinizi key parametresi yerine client parametresi olarak belirtin. Google Haritalar Platformu Premium Planı'nız varsa client veya key parametresini kullanabilirsiniz. Lisansınız yoksa client parametresi yerine key parametresini kullanmanız gerekir. Premium planı kimlik doğrulaması ile ilgili kılavuza göz atın.
KeyLooksLikeCryptoKey	Uyarı	key parametresi olarak bir şifreleme anahtarı veya imzalama gizli anahtarı sağlamış olabilirsiniz. Premium Plan veya Maps APIs for Work lisansınız varsa 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ı gerekmez. Google Haritalar Platformu Premium Planı'nız varsa client veya key parametresini kullanabilirsiniz. Lisansınız yoksa Cloud Console'da API anahtarı alabilirsiniz. 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 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 sağlamış olabilirsiniz. Lütfen uygulamanızı mevcut sürümlerden birini kullanacak şekilde güncelleyin. Versioning | Google Maps JavaScript API başlıklı makaleyi inceleyin.
SensorNotRequired	Uyarı	Maps JavaScript API için sensor parametresi artık gerekli değildir. Bu durum, Maps JavaScript API'nin doğru şekilde çalışmasını engellemez ancak sensor parametresini komut dosyası öğesinden kaldırmanızı öneririz.
SignatureNotRequired	Uyarı	Maps JavaScript API için signature parametresi gerekli değildir. Bu, Maps JavaScript API'nin doğru şekilde ç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çılmış özelliklerden yararlanı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 yeniden 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, bazı diğer tarayıcılarda window.console çıkışını kontrol etmek için kullanabileceğiniz araçların listesini aşağıda bulabilirsiniz.

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

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

1. Geliştirici Araçları'nı açmak için menü simgesi > Diğer Araçlar > Geliştirici Araçları'nı seçin.
2. 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ı şu 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ı tablosunu inceleyebilirsiniz. Hata mesajıyla ilgili ayrıntıları, mesajdan bağlantısı verilen API belgesinde de bulabilirsiniz.

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

Desteklenmeyen tarayıcıları işleme

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

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

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

Haritalar kodunuzu kullanmaya başlamanıza yardımcı olmak için Brendan Kenny ve Mano Marks 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 sık karşılaşılan 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.
  • Haritanın div öğesinin yüksekliğinin 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.
• Chrome Geliştirici Araçları'nda bulunan gibi bir JavaScript hata ayıklayıcı kullanarak sorunları belirleyin. Hataları bulmak için JavaScript konsoluna göz atarak başlayın.
• Sorularınızı Stack Overflow'da yayınlayın. Harika sorular sormayla ilgili yönergeleri Destek sayfasında bulabilirsiniz.