Hata İletileri

Bu sayfada, Maps JavaScript API. Maps JavaScript API yazmalar hata ve uyarı mesajlarını JavaScript konsoluna iletir. 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 bir API anahtarı veya faturalandırma ile ilgili sorunlar olduğunu gösterir. Google Haritalar Platformu ürünlerini kullanmak için hesabınızda faturalandırma etkinleştirilmiş olmalı ve tüm istekler geçerli bir API anahtarı içermelidir. 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 iç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ı görmek 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: dahil edilmemesine neden olabilir. API'nin çalışması için doğruca https://maps.googleapis.com adresinden yüklenmesi gerekir.

Bkz. Maps JavaScript API yükleniyor.

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

Başvurunuz Çeşitli e-posta bildirimlerinin ardından Google Haritalar Platformu Hizmet Şartları. Karara 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. Bu kılavuza göz atın: Premium Plan kimlik doğrulaması.

UnauthorizedURLForClientIdMapError Bu URL'nin, sağlanan Google Haritalar Müşteri Kimliği'ni kullanma yetkisi yok.

Premium Plan veya Maps for Work API'leri komut dosyası yükündeki istemci kimliği geçersiz, veya dosyayı yükleyen mevcut adres Maps JavaScript API, yetkili URL'ler.

Bkz. Yetkili URL'leri kaydetme

Maps JavaScript API Hata Kodları

Chrome JavaScript'te bir hata bulursanız Konsol, Firefox Web Konsolu 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. Bir hata, Maps JavaScript API. Sayfanız API'yi doğru şekilde yükleyemez, API bu sayfada çalışmaz. Uyarı, Maps JavaScript API. Uyarıda olası nedenler açıklanır veya kodunuzda Maps JavaScript API. Yalnızca hata içermeyen uyarılar alırsanız API çalışır. doğru şekilde ekleyebilirsiniz. Ancak bu olası sorunları gidermenizi öneririz. ele alacağız.

Geliştirici Hata Kodu Tür Açıklama
ApiNotActivatedMapError Hata

Maps JavaScript API, API projenizde etkin değil. Maps JavaScript API'yi, Google Cloud Console.

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

Bkz. Cloud Console'daki API anahtarları başlıklı makaleyi inceleyin. Daha fazla bilgi için bkz. API güvenliği en iyi uygulamaları.

DeletedApiProjectMapError Hata

API projeniz Cloud Console'dan silinmiş olabilir. Lütfen JavaScript API yükleyicisine dahil edilir. Yeni bir API projesi oluşturabilir ve Cloud Console'da yeni bir anahtar alabilirsiniz.

Yeni 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. Google Cloud'da faturalandırmayı etkinleştirmeniz gerekir Bu istemci kimliğiyle ilişkilendirilmiş proje, burada bulabilirsiniz.

BillingNotEnabledMapError Hata

Projenizde faturalandırmayı etkinleştirmemeniz bu hataya neden oluyor. Google Cloud projesinde faturalandırmayı etkinleştirmeniz gerekir burada bulabilirsiniz.

Daha fazla bilgi
ExpiredKeyMapError Hata

API'yi yükleyen komut dosyası öğesine dahil olan API anahtarında süresi dolmuştur veya sistem tarafından tanınmaz. Bu hatayı, yeni API anahtarı, sistem tarafından tanınmadan önce kullanmaya çalışırsanız. Birkaç dakika bekleyin dakika içinde tekrar deneyin. Alternatif olarak Cloud Console.

API anahtarı almak için aşağıdaki düğmeyi tıklayın.
. Başlarken

InvalidClientIdMapError Hata

API'yi yükleyen komut dosyası öğesine eklenen istemci kimliği: veya süresi dolmuştur. Lütfen istemci kimliğinizi kullandığınızdan emin olun sağlayabilir. İstemci kimliği "gme-" ile başlamalıdır ön eki ile değiştirebilirsiniz. Gördüğünüz istemci kimliğinizi doğru kullanırken bile bu hatayı alabilirsiniz. geçerlilik süresi doldu. Lütfen Google Hesap Yöneticinizle iletişime geçin.

Premium Plan'ınız yoksa Maps for Work API'leri lisansını kullanmak için key parametresini client yerine API anahtarınızla kullanmanız gerekir.

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

InvalidKeyMapError Hata

API'yi yükleyen komut dosyası öğesinde bulunan API anahtarı değil bulundu. Doğru API anahtarı 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şlarken

MalformedCredentialsMapError Hata

Uygulamanız, desteklenmeyen bir URI şeması kullanıyor. Uygulamanın bir RFC 3986'da tanımlandığı gibi geçerli URI biçimindedir.

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ı içeren key parametresi gerekir. Daha fazla bilgi için bkz. Google Haritalar Platformu'nu Kullanmaya Başlama.

Premium Plan müşterisiyseniz istemci kimliğinizle bir client parametresi veya bir key kullanın parametresini geçerli bir API anahtarı ile değiştirin. Daha fazla bilgi edinmek için API anahtarları ve istemci kimlikleri.

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

İsteğiniz tamamlanmadı. Daha fazla satış ve gelecek için hatayla ilgili ayrıntıları Cloud Console'da bulabilirsiniz.

Cloud Console'a göz atın.

RefererDeniedMapError Hata

Başvurunuz Çeşitli e-posta bildirimlerinin ardından Google Haritalar Platformu Hizmet Şartları. Karara 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.

RefererNotAllowedMapError Hata

Maps JavaScript API'yi yükleyen mevcut URL, izin verilen yönlendirenler listesine eklendi. Lütfen yönlendireni kontrol edin API anahtarınızın ayarlarını Cloud Console'da bulabilirsiniz.

Bkz. Maps JavaScript API ve API Anahtarı al.
OverQuotaMapError Hata

İstek sayısı, Maps JavaScript API. Uygulamanızın istekleri tekrar çalışacak her gün yeniden kontrol edebilirsiniz.

Web sitesinin sahibi DEĞİLSENİZ bu hatayı düzeltin. Ancak, mümkünse site sahibini bilgilendirmek isteyebilirsiniz.

Daha fazla bilgi için sınırlar hakkında 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 bkz. Google Haritalar Platformu'nu Kullanmaya Başlama.
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.

Aşağıdaki konular için rehberi inceleyin: 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. Bir Google Haritalar Platformu Premium Planı'nı seçerseniz bir client parametresi kullanabilirsiniz veya key parametresini kullanın. Hiç lisansınız yoksa client parametresi yerine bir key parametresi kullanmanız gerekir.

Aşağıdaki konular için rehberi inceleyin: Premium Plan kimlik doğrulaması.

InvalidChannel Uyarı

Geçersiz bir channel parametresi sağlamış olabilirsiniz. İlgili içeriği oluşturmak için kullanılan kanal, nokta ve karakter içeren ASCII alfanümerik bir dize olmalıdır (.), alt çizgi (_) ve kısa çizgi (-). Lütfen geçerli bir channel parametresi belirtmelisiniz.

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

InvalidClientId Uyarı

client parametresi doğru bir değer içermiyor girin. İstemci kimliği "gme-" ile başlamalıdır.

Aşağıdaki konular için rehberi inceleyin: Premium Plan kimlik doğrulaması.

InvalidKey Uyarı

API'yi yükleyen komut dosyası öğesinde bulunan API anahtarı emin olabilirsiniz. Doğru 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ş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. Şu durumda: Premium Plan kullanıyorsanız Maps for Work API'leri için lütfen istemci kimliğinizi key parametresi yerine client parametresini kullanmanız gerekir. Bir Google Haritalar Platformu Premium Planı'nı seçerseniz bir client parametresi kullanabilirsiniz veya key parametresini kullanın. Hiç lisansınız yoksa client parametresi yerine bir key parametresi kullanmanız gerekir.

Aşağıdaki konular için rehberi inceleyin: Premium Plan kimlik doğrulaması.

KeyLooksLikeCryptoKey Uyarı

key olarak bir şifreleme anahtarı veya imzalama sırrı 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 istemci kimliğinizi alın 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. Hiç lisansınız yoksa şunları yapabilirsiniz: Cloud Console'da bir API anahtarı alma.

Aşağıdaki konular için rehberi inceleyin: istemci kimliği ekleyin.

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ı öğesinin 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ı öğ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.

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. Bu özellik, Maps JavaScript API düzgün çalışmıyor, ancak ve güvenlik riskleri oluşturacaktır. 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ı engeller, ancak uygulamanızın davranışı değişebilir, oturum açılmış özellikleri kullanıyorsanız.

UrlAuthenticationCommonError Hata

Bu sayfadaki diğer kategorilere uymayan bir hata oluştu sayfasını ziyaret edin. Bunun nedeni geçici bir sorun olabilir. Lütfen kısa bir gecikme sonrasında talep etmenizi sağlar. 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 JavaScript Konsolu window.console çıkışını aşağıdaki gibi kontrol edin.

  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çıp kapatır. Konsolu kapatırsanız 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. Ayrıca, hata mesajı gösterilir.

Not: Aşağıdaki işlemleri yapabilirsiniz: kimlik doğrulama hatalarını dinleme daha fazla bilgi edindiniz.

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 hatalarını arayın. 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 yerleştirileceği bir div öğesi bildirdiğinizden emin olun. ekranda görünür.
    • Haritanın div öğesinin bir yüksekliği olduğundan emin olun. Varsayılan olarak div öğeleri 0 yüksekliğinde oluşturulduğu için görünmez.
    ziyaret edin. Ayrıntılı bilgi edinmek için referans göz önünde bulundurun.
  • Sorunları belirlemenize yardımcı olması için, mevcut olana benzer bir JavaScript hata ayıklayıcı kullanın Chrome Geliştirici Araçları. İlk olarak JavaScript konsolunda hatalara bakın.
  • Soruları Yığın'da yayınlayın Taşma. Etkili sorular yayınlamayla ilgili yönergeleri şurada bulabilirsiniz: Destek sayfası.