Hata Mesajları

Bu sayfada, Maps JavaScript API'nin döndürebileceği hata mesajları açıklanmaktadır. Maps JavaScript API, JavaScript konsoluna hata ve uyarı mesajları yazar. Belirli hata koşulları da ortaya çıkabilir ve bu durum, koyu renkli filigranlı bir haritanın görüntülenmesine neden olur.

API Anahtarı ve Faturalandırma Hataları

Sorun giderme

Belirli durumlarda, karartılmış bir harita veya "yalnızca geliştirme amaçlı" metniyle filigran içeren "negatif" bir Street View resmi görüntülenebilir. Bu davranış genellikle bir API anahtarı veya faturalandırma ile 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ı bulmayla ilgili 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ı, nedenlerin açıklamalarıyla ve sorunun nasıl düzeltileceğiyle birlikte listelenmiştir. Hata mesajlarını bulmayla ilgili 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ı 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 edilmemiştir. API'nin doğru ç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 sitesi, Google Maps API Hizmet Şartları'nı ihlal ediyor. Google Maps API bu web sitesi için devre dışı bırakıldı.

Uygulamanız, 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 ile yanıt alırsınız.

Google Haritalar Platformu Premium Plan lisansınız varsa bu hatayı çözmek için lütfen Google Haritalar Platformu Premium Plan kimlik bilgilerinizi kullanın. Premium Plan kimlik doğrulaması ile ilgili kılavuzu inceleyin.

UnauthorizedURLForClientIdMapError Bu URL'nin, sağlanan Google Haritalar istemci kimliğini kullanma yetkisi yok.

Komut dosyası yüklemesinde yer alan Premium Plan veya Maps APIs for Work istemci kimliği geçersiz, süresi dolmuş ya da Maps JavaScript API'yi yükleyen geçerli adres, yetkilendirilen URL'ler listesine eklenmemiş.

Yetkili URL'leri kaydetme bölümüne bakın.

Maps JavaScript API Hata Kodları

Chrome JavaScript Konsolu, Firefox Web Konsolu veya tarayıcılarınızdaki eşdeğer araçlarda bir hatayla karşılaşırsanız lütfen hata kodlarının açıklamalarını görmek için aşağıdaki tabloya bakın.

Maps JavaScript API hem hata hem uyarı döndürür. Hata mesajı, Maps JavaScript API yüklenirken oluşan ciddi bir sorunu belirtir. Sayfanız API'yi doğru şekilde yükleyemez ve API o sayfada çalışmaz. Uyarı, Maps JavaScript API'nin yüklenmesiyle ilgili ek bir mesajdır. Uyarıda, bir hatanın olası nedenleri açıklanır veya kodunuzda, Maps JavaScript API'yi yükleyen olası sorunlara işaret edilir. Yalnızca hata içermeyen uyarılar alırsanız API o sayfada doğru şekilde çalışır. Ancak bu olası sorunları da düzeltmenizi öneririz.

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

Maps JavaScript API, API projenizde etkinleştirilmedi. 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ılacağını Öğrenin

ApiTargetBlockedMapError Hata

Bu API anahtarının bu hizmeti veya API'yi kullanma yetkisi yok. 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'daki API anahtarları bölümüne bakın. Daha fazla bilgi için API güvenliği en iyi uygulamalarına göz atın.

DeletedApiProjectMapError Hata

API projeniz Cloud Console'dan silinmiş olabilir. Lütfen JavaScript API yükleyicide bulunan API anahtarını oluşturduğunuz projeyi kontrol edin. Cloud Console'da yeni bir API projesi oluşturabilir ve yeni anahtar alabilirsiniz.

Yeni proje oluşturmak ve proje için bir API anahtarı almak istiyorsanız aşağıdaki düğmeyi tıklayın.
Nasıl Yapılacağını Öğrenin

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 faturalandırmayı etkinleştirmediğiniz için bu hataya neden oluyor. Google Cloud projesinde Faturalandırmayı buradan etkinleştirmeniz gerekir.

Daha fazla bilgi

ExpiredKeyMapError Hata

API'yi yükleyen komut dosyası öğesinde bulunan 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 kullanmaya çalışırsanız bu hatayı alabilirsiniz. Birkaç dakika bekleyip tekrar deneyin. Alternatif olarak, 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şlayın

InvalidClientIdMapError Hata

API'yi yükleyen komut dosyası öğesinde bulunan istemci kimliği geçersiz veya süresi dolmuş. Lütfen istemci kimliğinizi doğru 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 API anahtarınızla client yerine bir key parametresi kullanmanız gerekir.

Premium Plan kimlik doğrulaması ile ilgili kılavuzu inceleyin.

InvalidKeyMapError Hata

API'yi yükleyen komut dosyası öğesinde bulunan API anahtarı bulunamadı. Lütfen 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şlayın

MalformedCredentialsMapError Hata

Uygulamanız desteklenmeyen bir URI şeması kullanıyor. Uygulamanın, RFC 3986'da tanımlandığı gibi 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ıyla bir 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 bir client parametresi veya geçerli bir API anahtarıyla bir key parametresi kullanmanız gerekir. Daha fazla bilgi için API anahtarları ve istemci kimlikleri kılavuzuna bakın.

Web sitesi 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 ayrıntıyı Cloud Console'da bulabilirsiniz.

Cloud Console'a göz atın.

RefererDeniedMapError Hata

Uygulamanız, 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 ile yanıt alırsınız.

RefererNotAllowedMapError Hata

Maps JavaScript API'yi yükleyen mevcut URL, izin verilen yönlendirenler listesine eklenmemiş. 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 için kullanım sınırlarını aştı. Uygulamanızın istekleri, bir sonraki günlük kota sıfırlama işleminde tekrar çalışır.

Web sitesi sahibi DEĞİLSENİZ bu hatayı düzeltmek için uygulayabileceğiniz bir adım yoktur. Ancak mümkünse site sahibini bilgilendirmek isteyebilirsiniz.

Daha fazla bilgi için kullanım sınırları rehberini inceleyin. Bu sayfada, kullanım sınırlarını nasıl yükseltebileceğiniz de açıklanmaktadır.

ApiProjectMapError Hata

Sağlanan API anahtarı veya ilişkili olduğu 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ı

client parametresinde bir şifreleme anahtarı sağlamış olabilirsiniz. Premium Plan veya Maps API for Work lisansınız varsa lütfen client parametresi olarak istemci kimliğinizi belirtin. Maps JavaScript API için şifreleme anahtarınızı kullanmanız gerekmez.

Premium Plan ve Maps API for Work müşterileri için istemci kimlikleri kılavuzuna bakın.

ClientIdLooksLikeKey Uyarı

client parametresinde bir API anahtarı sağlamış olabilirsiniz. Premium Plan veya Maps API for Work lisansınız varsa lütfen client parametresi olarak istemci kimliğinizi 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ı ile ilgili kılavuzu inceleyin.

InvalidChannel Uyarı

Geçersiz bir channel parametresi sağlamış olabilirsiniz. Kanal, nokta (.), alt çizgi (_) ve kısa çizgi (-) içerebilen ASCII alfanümerik bir dize olmalıdır. Lütfen geçerli bir channel parametresi belirttiğinizden emin olun.

Raporlama | Google Haritalar Platformu Premium Planı bölümüne bakın.

InvalidClientId Uyarı

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

Premium Plan kimlik doğrulaması ile ilgili kılavuzu inceleyin.

InvalidKey Uyarı

API'yi yükleyen komut dosyası öğesinde bulunan API anahtarı doğru görünmüyor. Lütfen 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şlayı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 Maps JavaScript API konusuna 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 istemci kimliğinizi key 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ı ile ilgili kılavuzu inceleyin.

KeyLooksLikeCryptoKey Uyarı

key parametresi olarak bir şifreleme anahtarı veya imzalama gizli anahtarı sağlamış olabilirsiniz. Premium Plan veya Maps API for Work lisansınız varsa lütfen istemci kimliğinizi client parametresi olarak belirtin ve komut dosyası öğenizden key parametresini kaldırın. Şifreleme anahtarı, Maps JavaScript API için gerekli değildir. Google Haritalar Platformu Premium Planınız varsa client parametresi veya key parametresi kullanabilirsiniz. Lisansınız yoksa Cloud Console'dan API anahtarı alabilirsiniz.

API'yi yüklerken istemci kimliği belirtme kılavuzunu inceleyin.

KeyLooksLikeProjectNumber Uyarı

key parametresi olarak bir proje numarası sağlamış olabilirsiniz. Lütfen doğru API anahtarı kullandığınızdan emin olun. Cloud Console'da yeni bir API anahtarı oluşturabilirsiniz.

API anahtarını nasıl 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ı eklediğinizden emin olun. Cloud Console'da yeni bir API anahtarı oluşturabilirsiniz.

API anahtarı almak için aşağıdaki düğmeyi tıklayarak işe başlayın.
Başlayın

Maps JavaScript API'yi kullanımdan kaldırılan v2 yolundan yüklüyorsanız key parametresini belirtseniz bile NoApiKeys uyarısını alırsınız. Lütfen v2'den v3'e geçiş kılavuzunu inceleyin 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.

Sürüm Oluşturma | Google Maps JavaScript API konusuna bakın.

SensorNotRequired Uyarı

sensor parametresi artık Maps JavaScript API için gerekli değildir. Bu, Maps JavaScript API'nin düzgün çalışmasını engellemez ancak komut dosyası öğesinden sensor parametresini kaldırmanızı öneririz.

SignatureNotRequired Uyarı

Maps JavaScript API için signature parametresi gerekli değildir. 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 kullandığınız Maps JavaScript API sürümünde desteklenmemektedir. Bu, Maps JavaScript API'nin çalışmasını engellemez ancak oturum açılmış özelliklerden yararlanıyorsanız uygulamanızın davranışı değişebilir.

UrlAuthenticationCommonError Hata

Bu sayfadaki diğer kategorilere uymayan bir hata oluştu. Bunun nedeni geçici bir sorun olabilir. Lütfen kısa bir süre sonra isteği yeniden deneyin. Bu işlem sorunu çözmezse isteğin uygun biçime sahip 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 adresine yazıyor. Bu bölümde, Google Chrome'da window.console çıkışını nasıl kontrol edebileceğiniz açıklanmaktadır. Başka tarayıcı kullanıyorsanız lütfen tarayıcınızın geliştirici belgelerine bakın. Referans olması açısından, window.console çıkışını diğer tarayıcılarda kontrol etmek için kullanabileceğiniz araçların yer aldığı bir listedir.

Chrome'da, window.console çıkışını aşağıdaki gibi kontrol etmek için JavaScript Konsolu'nu kullanabilirsiniz.

  1. Geliştirici Araçları'nı açmak için menü simgesi > Diğer Araçlar > Geliştirici Araçları'nı seçin.
  2. 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 herhangi bir hata veya uyarı oluşursa bunlar konsolda bir veya daha fazla satır olarak görünür. Hata veya uyarı mesajının biçimi şu şekildedir:

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ı tablosuna göz atabilirsiniz. Hata mesajıyla ilgili ayrıntıları mesajda bağlantısı 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 tarafından desteklendiğinden emin olun.

Web Görünümü'nde çalışan yerel bir Windows uygulaması geliştiriyorsanız Edge'e dayanan WebView2 kullandığınızdan emin olun. WebView'un Internet Explorer'a dayalı önceki sürümleri artık desteklenmemektedir.

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

Bu videoda, harita kodunuzu hazırlayıp çalıştırmanıza yardımcı olmak için Brendan Kenny ve Mano Marks, bazı yaygın hatalardan ve bunların nasıl düzeltileceğini ele alıyor.

  • Yazım hatası olup olmadığına bakın. 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 sırasında ortaya çıkar. Örneğin:
    • Harita seçeneklerinizde zoom ve center özelliklerini belirttiğinizi onaylayın.
    • Haritanın ekranda görüneceği bir div öğesi bildirdiğinizden emin olun.
    • Haritaya ait div öğesinin bir yüksekliğe sahip olduğundan emin olun. Varsayılan olarak, div öğeleri 0 yüksekliğinde oluşturulur ve bu nedenle görünmez.
    Referans uygulaması için örneklerimize bakın.
  • Sorunların tanımlanmasına yardımcı olması için Chrome Geliştirici Araçları'nda bulunan gibi bir JavaScript hata ayıklayıcısı kullanın. İlk olarak JavaScript konsolunda hatalar olup olmadığını kontrol edin.
  • Sorularınızı Stack Overflow'da yayınlayın. Doğru soruları nasıl yayınlayacağınızla ilgili yönergeleri Destek sayfasında bulabilirsiniz.