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. |
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. |
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.
|
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.
|
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. |
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.
|
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 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.
|
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 Premium Plan müşterisiyseniz istemci kimliğinizle birlikte bir 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ı |
Bu kılavuza göz atın: istemci Premium Plan ve Maps for Work müşterileri. |
ClientIdLooksLikeKey
|
Uyarı |
Bu kılavuza göz atın: Premium Plan kimlik doğrulaması. |
InvalidChannel
|
Uyarı |
Geçersiz bir Bkz. Raporlama | Google Haritalar Platformu Premium Planı'nı seçin. |
InvalidClientId
|
Uyarı |
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.
|
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ı |
API'yi yüklerken istemci kimliği belirtme kılavuzuna bakın. |
KeyLooksLikeProjectNumber
|
Uyarı |
|
NoApiKeys
|
Uyarı |
API'yi yükleyen komut dosyası öğesinde API anahtarı yok. Lütfen
API anahtarı almak için aşağıdaki düğmeyi tıklayarak başlayın.
Maps JavaScript API'yi desteği sonlandırılan v2'den yüklüyorsanız
yolda |
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ı |
|
SignatureNotRequired
|
Uyarı |
|
SignedInNotSupported
|
Uyarı |
|
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.
- Firefox için Web Konsolu.
- Android için uzaktan hata ayıklama.
- iOS için Web İnceleyici.
Chrome'da window.console
çıkışını kontrol etmek için JavaScript Konsolu'nu aşağıdaki gibi kullanabilirsiniz.
- Geliştirici Araçları'nı açmak için menü simgesini seçin > Diğer Araçlar > Geliştirici Araçları.
- 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ızdacenter
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.
- 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.