Hata mesajları

Bu sayfada, Haritalar JavaScript API'si tarafından döndürülebilecek hata mesajları açıklanmaktadır. Maps JavaScript API, JavaScript konsoluna hata ve uyarı mesajları yazar. Karanlık ve filigranlı bir haritanın görüntülenmesine neden olan belirli hata koşulları da ortaya çıkabilir.

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" bir Street View görüntüsü gösterilebilir. Bu davranış genellikle API anahtarıyla veya faturalandırmayla ilgili sorunları gösterir. Google Haritalar Platformu ü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 bölümüne bakın.

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

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

Aşağıdaki tablolarda, Haritalar JavaScript API'si tarafından döndürülen olası hata kodları, nedenin açıklaması ve sorunu nasıl düzelteceğinizle birlikte listelenmektedir. Hata mesajlarını bulma konusunda yardım için tarayıcınızdaki hataları kontrol etme bölümüne bakın.

Harita Yükleme Hataları

Maps JavaScript API'yi yüklerken hatayla karşılaşırsanız hata kodlarının açıklamalarını bulmak için lütfen aşağıdaki tabloya bakın.

Hata Kodu Mesaj Açıklama
NotLoadingAPIFromGoogleMapsError Maps JavaScript API doğrudan Google sunucularından indirilmelidir.

Maps JavaScript API'yi yükleyen komut dosyası öğesi sayfanıza doğru şekilde dahil edilmemiştir. API'nin doğru şekilde çalışabilmesi 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 Haritalar API Hizmet Şartları'nı ihlal ettiği anlaşılıyor. Google Haritalar API'si bu web sitesi için devre dışı bırakıldı.

Birkaç e-posta bildiriminin ardından, Google Haritalar Platformu Hizmet Şartları'na uyulmaması nedeniyle uygulamanız 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 alırsınız.

Google Haritalar Platformu Premium Plan lisansınız varsa bu hatayı düzeltmek için lütfen Google Haritalar Platformu Premium Plan kimlik bilgilerinizi kullanın. Premium Plan kimlik doğrulaması kılavuzunu inceleyin.

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

Komut dosyası yüklemesine dahil edilen Premium Plan veya İş için Haritalar API'leri istemci kimliği geçersiz, süresi dolmuş veya Maps JavaScript API'yi yükleyen mevcut adres, yetkili URL'ler listesine eklenmemiştir.

Yetkili URL'leri kaydettirme 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 hata bulursanız hata kodlarının açıklamalarını bulmak için lütfen aşağıdaki tabloya bakın.

Maps JavaScript API hem hata hem de uyarı döndürür. Hata, Maps JavaScript API yüklenirken meydana gelen 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üklenmesi hakkında ek bir mesajdır. Uyarı, hatanın olası nedenlerini açıklar veya kodunuzda Maps JavaScript API'yi yükleyen olası sorunları önerir. Yalnızca hata içermeyen uyarılar 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

API projenizde Maps JavaScript API etkin değil. Google Cloud Console'daki API'ler bölümünde 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ılır?

ApiTargetBlockedMapError Hata

Bu API anahtarı, bu hizmeti veya API'yi kullanma yetkisine sahip değil. 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ükleyicisine dahil edilen 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 meydana geliyor. 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 doldu veya sistem tarafından tanınmıyor. Yeni bir API anahtarı oluşturduktan sonra anahtarı sistem tarafından tanınmadan kullanmaya çalışırsanız bu hatayı alabilirsiniz. Birkaç dakika bekleyip tekrar deneyin. Aksi takdirde 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 meydana gelebilir.

Uygulama Kontrolü doğrulaması kılavuzunu inceleyin.

InvalidClientIdMapError Hata

API'yi yükleyen komut dosyası öğesine dahil edilen istemci kimliği geçersiz veya süresi dolmuş. Lütfen istemci kimliğinizi doğru şekilde kullandığınızdan emin olun. İstemci kimliği "gme-" önekiyle başlamalıdır. İstemci kimliğinizi doğru şekilde kullanırken bile bu hatayı görüyorsanız istemci kimliğinin süresi dolmuş olabilir. Lütfen Google hesap yöneticinizle iletişime geçin.

Premium Plan veya İş için Haritalar API'leri lisansınız yoksa API anahtarınızla birlikte client parametresi yerine key parametresi kullanmanız gerekir.

Premium Plan kimlik doğrulaması kılavuzunu inceleyin.

InvalidKeyMapError Hata

API'yi yükleyen komut dosyası öğesine dahil edilen 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ığından emin olun.

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 birlikte key parametresi 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ılavuzunu inceleyin.

Web sitesinin sahibi DEĞİLSENİZ bu hatayı düzeltmek için uygulayabileceğiniz bir adım yoktur. Ancak mümkünse site sahibini bilgilendirmek isteyebilirsiniz.

ProjectDeniedMapError Hata

İsteğiniz tamamlanmadı. Hatayla ilgili daha fazla bilgiyi Cloud Console'da bulabilirsiniz.

Cloud Console'u inceleyin.

RefererDeniedMapError Hata

Birkaç e-posta bildiriminin ardından, Google Haritalar Platformu Hizmet Şartları'na uyulmaması nedeniyle uygulamanız 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 alırsınız.

RefererNotAllowedMapError Hata

Maps JavaScript API'yi yükleyen mevcut URL, izin verilen yönlendiriciler listesine eklenmemiştir. Lütfen Cloud Console'da API anahtarınızın yönlendiren ayarlarını kontrol edin.

Maps JavaScript API'ye bakın ve API Anahtarı Alma başlıklı makaleyi inceleyin.

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ĞİLSENİZ bu hatayı düzeltmek için uygulayabileceğiniz bir adım yoktur. Ancak mümkünse site sahibini bilgilendirebilirsiniz.

Daha fazla bilgi için kullanım sınırlarıyla ilgili kılavuzu inceleyin. Bu sayfada, daha yüksek kullanım sınırlarını nasıl elde edebileceğiniz de açıklanmaktadır.

ApiProjectMapError Hata

Sağlanan API anahtarı veya ilişkili 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 kriptografik anahtar sağlamış olabilirsiniz. Premium Plan veya İş için Haritalar API'leri lisansınız varsa lütfen client parametresi olarak istemci kimliğinizi belirtin. Maps JavaScript API için şifreleme anahtarınızı kullanmanız gerekmez.

Premium Plan ve İş için Haritalar API'leri müşterilerinin istemci kimlikleri ile ilgili kılavuzu inceleyin.

ClientIdLooksLikeKey Uyarı

client parametresinde bir API anahtarı sağlamış olabilirsiniz. Premium Plan veya İş için Haritalar API'leri lisansınız varsa lütfen client parametresi olarak istemci kimliğinizi belirtin. Google Haritalar Platformu Premium Planınız varsa client parametresi veya key parametresi kullanabilirsiniz. Lisansınız yoksa client parametresi yerine key parametresi kullanmanız gerekir.

Premium Plan kimlik doğrulaması kılavuzunu inceleyin.

InvalidChannel Uyarı

Geçersiz bir channel parametresi sağlamış 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 Premium Planı başlıklı makaleyi inceleyin.

InvalidClientId Uyarı

client parametresinde doğru bir istemci kimliği bulunmuyor. İstemci kimliği "gme-" ile başlamalıdır.

Premium Plan kimlik doğrulaması kılavuzunu inceleyin.

InvalidKey Uyarı

API'yi yükleyen komut dosyası öğesine dahil edilen API anahtarı doğru görünmüyor. 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

InvalidVersion Uyarı

Komut dosyası öğenize 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 Numarası Atanması | Google Haritalar JavaScript API başlıklı makaleyi inceleyin.

KeyLooksLikeClientId Uyarı key parametresi olarak bir istemci kimliği sağlamış olabilirsiniz. Premium Plan veya Work için Haritalar API'leri 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 parametresi veya key parametresi kullanabilirsiniz. Lisansınız yoksa client parametresi yerine key parametresi kullanmanız gerekir.

Premium Plan kimlik doğrulaması kılavuzunu inceleyin.

KeyLooksLikeCryptoKey Uyarı

key parametresi olarak bir kriptografik anahtar veya imzalama gizlisi sağlamış olabilirsiniz. Premium Plan veya İş için Haritalar API'leri 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ı gerekli değildir. Google Haritalar Platformu Premium Planınız varsa client parametresi veya key parametresi kullanabilirsiniz. Lisansınız yoksa Cloud Console'da API anahtarı alabilirsiniz.

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 API anahtarını kullandığınızdan emin olun. Cloud Console'da yeni bir API anahtarı oluşturabilirsiniz.

API anahtarı nasıl alacağınızı öğrenin.

NoApiKeys Uyarı

API'yi yükleyen komut dosyası öğesinin 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ıklayın.
Başlayın

Maps JavaScript API'yi desteği sonlandı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ı öğenize 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.

Sürüm numaralandırması | Google Haritalar 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, Maps JavaScript API'nin düzgün çalışmasını engellemez ancak güvenlik riskleri oluşturabilir. Lütfen 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, Maps JavaScript API'nin çalışmasını engellemez ancak oturum açmış kullanıcılara yönelik özelliklere güveniyorsanız uygulamanızın davranışı değişebilir.

UrlAuthenticationCommonError Hata

Bu sayfada yer alan 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 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 alanına 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 dokümanlarını inceleyin. Diğer bazı tarayıcılarda window.console çıkışını kontrol etmek için kullanabileceğiniz araçları aşağıda bulabilirsiniz.

Chrome'da window.console çıkışını kontrol etmek için JavaScript Konsolu'nu aşağıdaki gibi 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çar veya kapatır. Konsolu kapatırsanız tekrar açmak için ESC tuşuna tekrar basın.

Haritalar 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ç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ı tablosunu kontrol edebilirsiniz. Hata mesajıyla ilgili ayrıntıları, iletiden bağlantı verilen API belgesinde de bulabilirsiniz.

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

Desteklenmeyen tarayıcılarla ilgili işlemler

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

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

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

Brendan Kenny ve Mano Marks, haritalar kodunuzu kullanıma sunmanıza yardımcı olmak için bu videoda sık yapılan bazı hatalara ve bunların nasıl düzeltileceğine değiniyor.

  • 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 işlemi 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 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 uygulama için örneklerimize göz atın.
  • Chrome Geliştirici Araçları'nda bulunanlar gibi bir JavaScript hata ayıklayıcı kullanarak sorunları tespit edebilirsiniz. JavaScript konsolunda hata olup olmadığına bakarak başlayın.
  • Sorularınızı Stack Overflow'a gönderin. Etkileyici sorular yayınlamayla ilgili yönergeleri Destek sayfasında bulabilirsiniz.