Bu sayfada, Maps JavaScript API tarafından döndürülebilen hata mesajları açıklanmaktadır. Maps JavaScript API, JavaScript konsoluna hata ve uyarı mesajları yazar. Bazı hata koşulları da ortaya çıkabilir. Bunun sonucunda, koyu renkli bir filigranlı harita görüntülenebilir.
API Anahtarı ve Faturalandırma Hataları
Sorun giderme
Belirli durumlarda, "yalnızca geliştirme amaçlı" filigranı içeren koyu renkli bir harita veya "negatif" Street View resmi görüntülenebilir. Bu davranış genellikle bir API anahtarı veya faturalandırmayla ilgili sorunları gösterir. Google Haritalar Platformu ürünlerini kullanabilmeniz için hesabınızda faturalandırmanın etkinleştirilmiş olması 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 için Maps JavaScript API Hata Kodları
Aşağıdaki tablolarda, Haritalar JavaScript API'si tarafından döndürülen olası hata kodları ve bu durumun nedeni ile birlikte, sorunu nasıl düzeltebileceğiniz açıklanmaktadır. 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 bir hatayla karşılaşırsanız hata kodlarıyla ilgili açıklamaları görmek için lütfen aşağıdaki tabloya bakın.
Hata Kodu | Message | Açıklama |
---|---|---|
NotLoadingAPIFromGoogleMapsError
|
Maps JavaScript API, doğrudan Google'ın sunucularından indirilmelidir. |
Maps JavaScript API'yi yükleyen komut dosyası öğesi, sayfanıza doğru şekilde dahil edilmiyor. API'nin doğru bir şekilde çalışması için doğrudan https://maps.googleapis.com adresinden yüklenmesi gerekir. Maps JavaScript API'yi yükleme bölümüne bakın. |
TOSViolationMapError
|
Bu web sitesinin Google Haritalar API'sı Hizmet Şartları'nı ihlal ettiği görülüyor. Google Haritalar API'sı bu web sitesi için devre dışı bırakıldı. |
Başvurunuz, birkaç e-posta bildiriminin ardından Google Haritalar Platformu Hizmet Şartları'na uymadığı için 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-posta yoluyla yanıt alacaksı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'nin, sağlanan Google Haritalar İstemci Kimliğini kullanma yetkisi yok. |
Komut dosyası yüklemeye dahil edilen Premium Plan veya Maps API for Work istemci kimliği geçersiz, süresi dolmuş veya Maps JavaScript API'yi yükleyen geçerli adres, yetkili URL'ler listesine eklenmemiştir. Yetkili URL'leri kaydetme bölümüne bakın. |
Maps JavaScript API Hata Kodları
Chrome JavaScript Console, Firefox Web Console veya tarayıcılarınızdaki diğer eşdeğer araçlarda hata bulursanız hata kodlarıyla ilgili açıklamaları görmek için lütfen aşağıdaki tabloya bakın.
Maps JavaScript API hem hatalar hem de uyarılar döndürür. Bir hata, Maps JavaScript API yüklenirken oluşan ciddi bir sorun olduğunu gösterir. Sayfanız API'yi doğru bir şekilde yükleyemeyeceğinden API bu sayfada çalışmaz. Uyarı, Maps JavaScript API'nin yüklenmesiyle ilgili ek bir mesajdır. Uyarı, bir hatanın olası nedenlerini açıklar veya kodunuzda Maps JavaScript API'yi yükleyen olası sorunları belirtir. Yalnızca hata içermeyen uyarılar alırsanız API, bu sayfada düzgün bir şekilde çalışır. Ancak bu potansiyel sorunları da düzeltmenizi öneririz.
Geliştirici Hata Kodu | Type | Açıklama |
---|---|---|
ApiNotActivatedMapError
|
Hata |
Maps JavaScript API, API projenizde etkinleştirilmemiş. Google Cloud Console'da API'ler altında Maps JavaScript API'yi etkinleştirmeniz gerekebilir. Projenizde Maps JavaScript API'yi etkinleştirmek için aşağıdaki düğmeyi tıklayın.
|
ApiTargetBlockedMapError
|
Hata |
Bu API anahtarının bu hizmeti veya API'yi kullanma yetkisi yok. Kullanmanız gereken tüm API 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ı bölümüne bakın. Daha fazla bilgi için API güvenliği en iyi uygulamaları konusuna bakın. |
DeletedApiProjectMapError
|
Hata |
API projeniz Cloud Console'dan silinmiş olabilir. Lütfen JavaScript API yükleyicisinde yer alan 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 bir API anahtarı almak üzere aşağıdaki düğmeyi tıklayın.
|
ClientBillingNotEnabledMapError
|
Hata |
Projenizde faturalandırmayı etkinleştirmediniz. Bu istemci kimliğiyle ilişkili Google Cloud projesinde faturalandırmayı buradan etkinleştirmeniz gerekir. |
BillingNotEnabledMapError
|
Hata |
Projenizde bu hataya neden olan faturalandırmayı etkinleştirmediniz. Google Cloud projesinde faturalandırmayı buradan etkinleştirmeniz gerekir. |
ExpiredKeyMapError
|
Hata |
API'yi yükleyen komut dosyası öğesine eklenen API anahtarının süresi dolmuş veya sistem tarafından tanınmıyor. Yeni bir API anahtarı oluşturduktan sonra anahtarı sistem tarafından tanınmadan önce kullanmayı denerseniz bu hatayı alabilirsiniz. Birkaç dakika bekleyip tekrar deneyin. Bunun yerine Cloud Console'da yeni bir API anahtarı oluşturmanız gerekebilir. API anahtarı almak için aşağıdaki düğmeyi tıklayı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 doğru şekilde kullandığınızdan emin olun. İstemci kimliği "gme-" önekiyle başlamalıdır. İstemci kimliğinizi doğru 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 Maps API for Work lisansınız yoksa Premium Plan kimlik doğrulaması kılavuzunu inceleyin. |
InvalidKeyMapError
|
Hata |
API'yi yükleyen komut dosyası öğesine eklenen API anahtarı bulunamadı. Lütfen doğru bir 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.
|
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ığını doğrulayın. |
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 bir Premium Plan müşterisiyseniz istemci kimliğinizle birlikte bir Web sitesinin sahibi DEĞİLSENİZ bu hatayı düzeltmek için uygulayabileceğiniz herhangi 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 bakın. |
RefererDeniedMapError
|
Hata |
Başvurunuz, birkaç e-posta bildiriminin ardından Google Haritalar Platformu Hizmet Şartları'na uymadığı için 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-posta yoluyla yanıt alacaksınız. |
RefererNotAllowedMapError
|
Hata |
Maps JavaScript API'yi yükleyen geçerli URL, izin verilen yönlendirenler listesine eklenmedi. Lütfen Cloud Console'da API anahtarınızın yönlendiren ayarlarını kontrol edin. Maps JavaScript API ve API Anahtarı Alma bölümünü 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ırlandığında tekrar çalışır. Web sitesinin sahibi DEĞİLSENİZ bu hatayı düzeltmek için uygulayabileceğiniz herhangi bir adım yoktur. Ancak, mümkünse site sahibini bilgilendirmek isteyebilirsiniz. Daha fazla bilgi için kullanım sınırları kılavuzuna bakın. Bu sayfada nasıl daha yüksek kullanım sınırları edinebileceğiniz de açıklanmaktadır. |
ApiProjectMapError
|
Hata |
Sağlanan API anahtarı veya ilişkilendirildiği API projesi çözülemedi. 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 bölümüne bakın. |
ClientIdLooksLikeCryptoKey
|
Uyarı |
Premium Plan ve Maps API for Work müşterileri için istemci kimlikleri kılavuzunu inceleyin. |
ClientIdLooksLikeKey
|
Uyarı |
Premium Plan kimlik doğrulaması kılavuzunu inceleyin. |
InvalidChannel
|
Uyarı |
Geçersiz bir Raporlama | Google Haritalar Platformu Premium Planı'nı inceleyin. |
InvalidClientId
|
Uyarı |
Premium Plan kimlik doğrulaması kılavuzunu inceleyin. |
InvalidKey
|
Uyarı |
API'yi yükleyen komut dosyası öğesine eklenen API anahtarı doğru görünmüyor. Lütfen doğru bir 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.
|
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. Sürüm Oluşturma | Google Haritalar JavaScript API'si başlıklı makaleye bakın. |
KeyLooksLikeClientId
|
Uyarı |
key parametresi olarak bir istemci kimliği sağlamış olabilirsiniz. Premium Plan veya Maps API for Work lisansınız varsa lütfen müşteri parametrenizi key parametresi yerine client parametresi olarak belirtin. Google Haritalar Platformu Premium Plan'ınız varsa client veya key parametresi kullanabilirsiniz. Lisansınız yoksa client
parametresi yerine bir key parametresi kullanmanız gerekir.
Premium Plan kimlik doğrulaması kılavuzunu inceleyin. |
KeyLooksLikeCryptoKey
|
Uyarı |
API'yi yüklerken istemci kimliği belirtme kılavuzunu inceleyin. |
KeyLooksLikeProjectNumber
|
Uyarı |
API anahtarının nasıl alınacağını öğrenin. |
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.
Haritalar JavaScript API'sini kullanımdan kaldırılan v2 yolundan yüklüyorsanız |
RetiredVersion
|
Uyarı |
Komut dosyası öğenizde kullanımdan kaldırılmış bir sürüm sağlamış olabilirsiniz. Lütfen mevcut sürümlerden birini kullanarak uygulamanızı güncelleyin. Sürüm Oluşturma | Google Haritalar JavaScript API'si başlıklı makaleye bakın. |
SensorNotRequired
|
Uyarı |
|
SignatureNotRequired
|
Uyarı |
|
SignedInNotSupported
|
Uyarı |
|
UrlAuthenticationCommonError
|
Hata |
Bu sayfadaki 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 lütfen isteğin doğru biçime sahip olduğundan emin olmak için geliştirici kılavuzunu inceleyin. |
Tarayıcınızdaki Hataları Kontrol Etme
Maps JavaScript API, window.console
öğesine hata mesajları 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ı kontrol edin. Bu listede, başka tarayıcılardaki window.console
çıkışını kontrol edebileceğiniz bir araç listesi bulunmaktadır.
- Firefox için Web Console.
- Android için uzaktan hata ayıklama.
- iOS için Web Inspector.
Chrome'da window.console
çıkışını aşağıdaki şekilde kontrol etmek için JavaScript Konsolu'nu 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/kapatır. Konsolu kapatırsanız açmak için ESC tuşuna tekrar basın.
Maps JavaScript API 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ılara, mesajdan bağlantı verilen API dokümanında da ulaşabilirsiniz.
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 tarafından desteklendiğinden emin olun.
Web Görünümü'nde çalışan yerel bir Windows uygulaması geliştiriyorsanız Edge tabanlı WebView2'yi kullandığınızdan emin olun. Internet Explorer'ı temel alan Web Görünümü'nün önceki sürümleri artık desteklenmemektedir.
Kodunuz hâlâ çalışmıyorsa
Brendan Kenny ve Mano Marks, harita kodunuzu oluşturup çalıştırmanıza yardımcı olmak için bu videoda sık yapılan bazı hatalardan ve bu hataların nasıl düzeltileceğinden bahsediyor.
- Yazım hatası olup olmadığına bakın. JavaScript'in büyük/küçük harfe duyarlı bir dil olduğunu unutmayın.
- Temel noktaları inceleyin. En yaygın sorunlardan bazıları ilk harita oluşturma sırasında ortaya çıkar. Örneğin:
- Harita seçeneklerinizde
zoom
vecenter
özelliklerini belirttiğinizi onaylayın. - Haritanın ekranda gösterileceği bir div öğesi belirttiğinizden emin olun.
- Harita için div öğesinin bir yüksekliği olduğundan emin olun. Varsayılan olarak div öğeleri 0 yüksekliğinde oluşturulur ve bu nedenle görünmez.
- Harita seçeneklerinizde
- JavaScript hata ayıklayıcısını kullanarak Chrome Geliştirici Araçları'ndakiler gibi sorunları tespit edebilirsiniz. JavaScript konsolunda hata olup olmadığını inceleyerek başlayın.
- Sorularınızı Stack Overflow'da yayınlayın. Mükemmel soruları yayınlamayla ilgili kuralları Destek sayfasında bulabilirsiniz.