Hata İletileri

Bu sayfada, Maps JavaScript API. Maps JavaScript API, JavaScript konsoluna hata ve uyarı mesajları yazar. Belirli hata koşullar da ortaya çıkabilir ve bu da sonuçta ekranın filigranlı haritadır.

API Anahtarı ve Faturalandırma Hataları

Sorun giderme

Belirli koşullar altında, koyu renkli bir harita veya "negatif" "Yalnızca geliştirme amaçlı" ifadesi bulunan filigranlı Street View resmi, 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 almak için tarayıcınızdaki hataları kontrol etme.

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, Maps JavaScript API, nedenin bir açıklaması ve bunu nasıl sorunu çözmek için çalışır. Hata mesajlarını bulma konusunda yardım almak için tarayıcınızdaki hataları kontrol etme.

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'ın sunucular.

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.

Bkz. Maps JavaScript API yükleniyor.

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ı.

Başvurunuz Çeşitli e-posta bildirimlerinin ardından Google Haritalar Platformu Hizmet Şartları. Karara itiraz etmek için ve uygulamanızın incelenmesini bekleyin, lütfen bu formu doldurun. Birkaç iş günü içinde e-postayla bir yanıt alacaksınız.

Google Haritalar Platformu Premium Plan lisansınız varsa lütfen Bu hatanın çözülmesi için Google Haritalar Platformu Premium Planı kimlik bilgileri. 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 Maps APIs for Work istemci kimliği geçersiz, süresi dolmuş veya Maps JavaScript API'yi yükleyen mevcut adres, yetkili URL'ler listesine eklenmemiştir.

Bkz. Yetkili URL'leri kaydetme

Maps JavaScript API Hata Kodları

Chrome JavaScript'te bir hata bulursanız Konsol, Firefox Web Console veya tarayıcılarınızdaki diğer eşdeğer araçlar, hata kodlarının açıklamalarını görmek 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. 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 çalışır. doğru şekilde ekleyebilirsiniz. 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ının bu hizmeti veya API'yi kullanma yetkisi yok. Lütfen kontrol edin API anahtarınızın API kısıtlamaları ayarlarını Google Cloud Console sayesinde ihtiyaç duyduğunuz tüm API'lerin ve hizmetlerin etkin API'ler listesinde doğru şekilde belirtildiğinden emin olun.

Cloud Console'daki 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ılacağını Öğrenin

ClientBillingNotEnabledMapError Hata

Projenizde faturalandırmayı etkinleştirmemişsinizdir. Google Cloud'da faturalandırmayı etkinleştirmeniz gerekir Bu istemci kimliğiyle ilişkilendirilmiş proje, burada bulabilirsiniz.

BillingNotEnabledMapError Hata

Projenizde faturalandırmayı etkinleştirmediğiniz için bu hata meydana geliyor. Google Cloud projesinde faturalandırmayı etkinleştirmeniz gerekir burada bulabilirsiniz.

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. Bu hatayı, yeni API anahtarı, sistem tarafından tanınmadan önce kullanmaya çalışırsanız. 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şlarken

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ılavuzuna bakın.

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 kullandığınızdan emin olun sağlayabilir. İ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 client parametresi yerine key parametresi kullanmanız gerekir.

Bu kılavuza göz atın: Premium Plan kimlik doğrulaması.

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. Şunları yapabilirsiniz: Cloud Console'da yeni bir API anahtarı oluşturma.

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'a göz atın.

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 bir yanıt alacaksı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 daha fazla bilgi edinin. Sayfada, potansiyelinizi artırmak için nasıl daha iyi olabileceğinizi de izin verir.

ApiProjectMapError Hata

Sağlanan API anahtarı veya ilişkilendirildiği API projesi, çözülemedi. Bu hata geçici olabilir. Bu hata mesajı yeni bir API anahtarı almanız veya yeni 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 içinde bir şifreleme anahtarı sağlamış olabilirsiniz parametresinden sonra bir değer girin. Premium Plan kullanıyorsanız veya Maps for Work lisansı (lütfen belirtin) client parametresi olarak kullanın. Herhangi bir teknik Maps JavaScript API için şifreleme anahtarınızı kullanmanız gerekir.

Bu kılavuza göz atın: istemci Premium Plan ve Maps for Work müşterileri.

ClientIdLooksLikeKey Uyarı

client parametresinde bir API anahtarı sağlamış olabilirsiniz. Premium Plan kullanıyorsanız veya Maps for Work lisansı, lütfen istemcinizi belirtin client parametresi olarak kimlik. Google Haritalar Platformu Premium Planınız varsa client parametresi veya key parametresi kullanabilirsiniz. Hiç lisansınız yoksa client parametresi yerine bir key parametresi kullanmanız gerekir.

Bu kılavuza göz atın: Premium Plan kimlik doğrulaması.

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.

Bkz. Raporlama | Google Haritalar Platformu Premium Planı'nı seçin.

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ı öğesinde bulunan API anahtarı emin olabilirsiniz. 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şlarken

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.

Bkz. Sürüm Oluşturma | Google Haritalar JavaScript API'si hakkında daha fazla bilgi edinin.

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 olarak bir şifreleme anahtarı veya imzalama sırrı sağlamış olabilirsiniz parametresinden sonra bir değer girin. 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. Şifreleme anahtarı, Maps JavaScript API için gerekli değildir. Bir Google Haritalar Platformu Premium Planı'nı seçerseniz bir client parametresi kullanabilirsiniz veya key parametresini kullanın. 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. Doğru API anahtarı kullandığınızdan emin olun. Yeni bir web sitesi oluşturabilirsiniz. Cloud Console'da API anahtarı.

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

NoApiKeys Uyarı

API'yi yükleyen komut dosyası öğesinde API anahtarı yok. Lütfen key parametresi olarak geçerli bir API anahtarı eklemeniz gerekir. 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şlarken

Maps JavaScript API'yi desteği sonlandırılan v2'den yüklüyorsanız yolda NoApiKeys uyarısını alırsınız, key parametresini kullanın. Lütfen v2'den v3'e yükseltme kılavuzu 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.

Bkz. Sürüm Oluşturma | Google Haritalar JavaScript API'si hakkında daha fazla bilgi edinin.

SensorNotRequired Uyarı

sensor parametresi Maps JavaScript API. Bu özellik, Maps JavaScript API düzgün çalışmıyor, ancak sensor parametresini komut dosyası öğesinden kaldırmanız gerekir.

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 bunu komut dosyası öğenizden kaldırın.

SignedInNotSupported Uyarı

signed_in parametresi kullanımdan kaldırıldı ve sürümde desteklenmiyor URL'sini inceleyin. 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 gecikmeden sonra yeniden gönderin. Sorununuz çözülmediyse lütfen şurayı gözden geçirin: geliştirici kılavuzu .

Tarayıcınızdaki Hataları Kontrol Etme

Maps JavaScript API, window.console Bu bölümde, kampanyalarınızı yönetmek için Google Chrome'da window.console çıkışı. için lütfen tarayıcınızın geliştirici dokümanlarına bakın. Sizin için: Bu, window.console çıkışını kontrol edecek araçların listesidir bazı tarayıcılarda da görüntülenebilir.

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ü simgesini seçin > Diğer Araçlar > Geliştirici Araçları.
  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.

Maps JavaScript API'de bir veya daha fazla satır halinde konsolu. 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]

Aşağıdakileri öğrenmek için yukarıdaki hata kodları tablosunu hata mesajındaki hata kodu. 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ıları işleme

Kullandığınız tarayıcı sürümünün şu anda Maps JavaScript API.

WebView'da çalışan yerel bir Windows uygulaması geliştiriyorsanız WebView2 tabanlı bir uygulama yayınladık. Internet Explorer'a dayalı olarak WebView'un önceki sürümleri artık desteklenmemektedir.

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

Haritalar kodunuzu hazır hale getirmenize yardımcı olmak için Brendan Kenny ve Mano Marks, ve bunların nasıl düzeltileceğine değineceğiz.

  • Yazım hatası olup olmadığını kontrol edin. JavaScript'in büyük/küçük harfe duyarlı olduğunu unutmayın dili'ne dokunun.
  • Temel bilgileri kontrol edin. En yaygın sorunlardan bazıları ilk harita oluşturma. Örneğin:
    • zoom özelliğini belirttiğinizi onaylayın ve haritanızda center tesis var seçenekleri vardır.
    • 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 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ı Yığın'da yayınlayın Taşma. Etkileyici sorular yayınlamayla ilgili yönergeleri Destek sayfasında bulabilirsiniz.