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.
|
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.
|
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. |
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.
|
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 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.
|
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'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ı |
Premium Plan ve İş için Haritalar API'leri müşterilerinin istemci kimlikleri ile ilgili kılavuzu inceleyin. |
ClientIdLooksLikeKey
|
Uyarı |
Premium Plan kimlik doğrulaması kılavuzunu inceleyin. |
InvalidChannel
|
Uyarı |
Geçersiz bir Raporlama | Google Haritalar Platformu Premium Planı başlıklı makaleyi inceleyin. |
InvalidClientId
|
Uyarı |
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.
|
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ı |
API'yi yüklerken istemci kimliği belirtme kılavuzuna bakın. |
KeyLooksLikeProjectNumber
|
Uyarı |
API anahtarı nasıl alacağınızı öğrenin. |
NoApiKeys
|
Uyarı |
API'yi yükleyen komut dosyası öğesinin API anahtarı yok. Lütfen
API anahtarı almak için aşağıdaki düğmeyi tıklayın.
Maps JavaScript API'yi desteği sonlandırılan v2 yolundan yüklüyorsanız |
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ı |
|
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 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.
- 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ü simgesi > Diğer Araçlar > Geliştirici Araçları'nı seçin.
- 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
vecenter
ö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.
- Harita seçeneklerinizde
- 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.