Hata Mesajları

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Bu sayfada, Maps JavaScript API tarafından döndürülen hata mesajları açıklanmaktadır. Maps JavaScript API, JavaScript konsoluna hata ve uyarı mesajları yazar. Belirli hata durumları da meydana gelebilir. Sonuçta, koyu renkli, filigranlı bir harita görüntülenir.

API Anahtarı ve Faturalandırma Hataları

Sorun giderme

Belirli durumlarda, "sadece geliştirme amaçlı" filigranına sahip koyu renkli bir harita veya "negatif" Street View resmi gösterilebilir. Bu davranış genellikle API anahtarı veya faturalandırmayla ilgili sorunları gösterir. Google Haritalar Platformu ürünlerini kullanabilmek 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 almak 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, Maps JavaScript API tarafından döndürülen olası hata kodları listelenmekte ve sorunun nedeni ile sorunun nasıl düzeltilebileceği açıklanmaktadır. Hata mesajlarını bulmayla ilgili yardım almak 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ıyla ilgili açıklamaları 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ından indirilmelidir.

Maps JavaScript API'yi yükleyen komut dosyası öğesi sayfanıza doğru şekilde dahil edilmiyor. API'nin düzgün çalışması için doğrudan https://maps.googleapis.com adresinden yüklenmesi gerekir.

Maps JavaScript API'yi yükleme konusuna bakın.

TOSViolationMapError Bu web sitesinin Google Maps API Hizmet Şartları'nı ihlal ettiği anlaşı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 başvurunuzun incelenmesini sağlamak için lütfen bu formu doldurun. Birkaç iş günü içinde e-postayla yanıt alacaksı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ı 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 eklenmedi.

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çlarla ilgili bir hata bulursanız lütfen hata tablolarıyla ilgili açıklamaları görmek için 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 ciddi bir sorun oluştuğunu belirtir. Sayfanız API'yi doğru şekilde yükleyemez ve API o sayfada çalışmaz. Uyarı mesajı, Maps JavaScript API'nin yüklenmesiyle ilgili ek bir mesajdır. Uyarı, hatanın olası nedenlerini açıklar veya kodunuzda Maps JavaScript API'yi yükleyen olası sorunlara işaret eder. Herhangi bir hata olmadan yalnızca uyarı alırsanız API, o sayfada düzgün ç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 etkin değil. Google JavaScript Konsolu'ndaki API'lerin 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.
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 ve hizmetlerin etkin API'ler listesinde doğru şekilde belirtildiğinden emin olmak için lütfen Google Cloud Console'daki 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 edinmek için API güvenliği en iyi uygulamaları bölümüne bakın.

DeletedApiProjectMapError Hata

API projeniz Cloud Console'dan silinmiş olabilir. JavaScript API yükleyicisine dahil edilen API anahtarını oluşturduğunuz projeyi kontrol edin. Cloud Console'da yeni bir API projesi oluşturup 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.
Nasıl Yapılacağını Öğrenin

ClientBillingNotEnabledMapError Hata

Projenizde faturalandırmayı etkinleştirmediniz. Bu istemci kimliğiyle ilişkili olan Google Cloud projesinde faturalandırmayı buradan etkinleştirmelisiniz.

BillingNotEnabledMapError Hata

Projenizde faturalandırmayı etkinleştirmemeniz bu hataya neden oluyor. Google Cloud Projesi'nde faturalandırmayı buradan etkinleştirmelisiniz.

Daha fazla bilgi

ExpiredKeyMapError Hata

API'yi yükleyen komut dosyası öğesine eklenen API anahtarının süresi dolmuş veya sistem tarafından tanınmadı. 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 veya 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ı öğesine eklenen 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-" ön eki ile 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 Maps API for Work lisansınız yoksa client parametresi yerine API anahtarınızla bir key parametresi kullanmanız gerekir.

Premium Plan kimlik doğrulaması kılavuzunu inceleyin.

InvalidKeyMapError Hata

API'yi yükleyen komut dosyası öğesine eklenen API anahtarı bulunamı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.
Başlayı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 key parametresi kullanmanız gerekir. Daha fazla bilgi için Google Haritalar Platformu'nu Kullanmaya Başlama bölümüne bakın.

Premium Plan müşterisiyseniz istemci kimliğinizle bir client parametresi veya geçerli bir API anahtarı içeren bir key parametresi kullanmanız gerekir. Daha fazla bilgi için API anahtarları ve istemci kimlikleri kılavuzuna bakın.

Web sitesinin sahibi DEĞİLSENİZ bu hatayı düzeltmek için uygulayabileceğiniz herhangi bir adım yoktur. Bununla birlikte, 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 başvurunuzun incelenmesini sağlamak için lütfen bu formu doldurun. Birkaç iş günü içinde e-postayla 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ümlerine bakın.

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ırlamasında tekrar çalışır.

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

Daha fazla bilgi için kullanım sınırları kılavuzuna bakın. Bu sayfada ayrıca daha yüksek kullanım sınırları nasıl elde edebileceğiniz de açıklanmaktadır.

ApiProjectMapError Hata

Sağlanan API anahtarı veya ilişkilendirildiği 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 bölümüne bakın.

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 veya key parametresi kullanabilirsiniz. Lisansınız yoksa client parametresi yerine key parametresini kullanmanız gerekir.

Premium Plan kimlik doğrulaması kılavuzunu 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ı'nı inceleyin.

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ı 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 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.
Başlayın

InvalidVersion Uyarı

Komut dosyası öğenizde yanlış bir sürüm numarası sağladınız. Lütfen doğru bir sürüm numarası kullandığınızdan emin olun.

Sürüm Oluşturma | Google Haritalar JavaScript API'si başlıklı yardım makalesini inceleyin.

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 key parametresi yerine istemci kimliğinizi client parametresi olarak belirtin. Google Haritalar Platformu Premium Plan'ınız varsa client veya key parametresi kullanabilirsiniz. Lisansınız yoksa client parametresi yerine key parametresini kullanmanız gerekir.

Premium Plan kimlik doğrulaması kılavuzunu inceleyin.

KeyLooksLikeCryptoKey Uyarı

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

API'yi yüklerken istemci kimliği belirtme kılavuzuna bakın.

KeyLooksLikeProjectNumber Uyarı

key parametresi olarak bir proje numarası sağlamış olabilirsiniz. Lütfen doğru API anahtarını 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ı öğesinde API anahtarı yok. Lütfen key parametresi için geçerli bir API anahtarı ekleyin. 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ş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ş rehberini 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 kullanılabilir sürümlerden birini kullanmak için uygulamanızı güncelleyin.

Sürüm Oluşturma | Google Haritalar JavaScript API'si başlıklı yardım makalesini inceleyin.

SensorNotRequired Uyarı

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

SignatureNotRequired Uyarı

signature parametresi, Maps JavaScript API için gerekli değildir. Maps JavaScript API'nin düzgün çalışmasını engellemese de güvenlik risklerine yol açabilir. Lütfen komut dosyanızı kaldırın.

SignedInNotSupported Uyarı

signed_in parametresi kullanımdan kaldırılmıştır ve kullandığınız Maps JavaScript API sürümünde desteklenmiyor. Bu, Maps JavaScript API'nin çalışmasını engellemez ancak, oturum açılmış özelliklere güvenirseniz uygulamanızın davranışı değişebilir.

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 gecikmenin ardından isteği yeniden deneyin. Bu işlem sorunu çözmezse isteğin doğru biçimi 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 yazar. Bu bölümde, Google Chrome'da window.console çıkışını nasıl kontrol edebileceğiniz açıklanmıştır. Başka bir tarayıcı kullanıyorsanız lütfen tarayıcınızın geliştirici belgelerini kontrol edin. Bu, diğer tarayıcılarda window.console çıkışını kontrol etmek için kullanabileceğiniz araçların bir listesidir.

Chrome'da window.console çıkışını aşağıdaki şekilde 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 hata veya uyarı oluşursa bunlar konsolda bir veya daha fazla satır olarak görünür. Hata veya uyarı mesajı 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ı, mesajdan bağlantı verilen API dokümanında da bulabilirsiniz.

Not: Kimlik doğrulama hatalarını programatik olarak dinleyebilirsiniz.

Desteklenmeyen tarayıcıları kullanma

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 dayalı olarak WebView2'yi kullandığınızdan emin olun. Internet Explorer tabanlı 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 hazırlayıp çalışır hale getirmenize yardımcı olmak için bu videoda sık karşılaşılan bazı hatalara ve hataların nasıl düzeltileceğine odaklanıyor.

  • Yazım hataları 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 sık karşılaşılan sorunlardan bazıları ilk harita oluşturma sırasında ortaya çıkar. Örneğin:
    • Harita seçeneklerinizde zoom ve center özelliklerini belirttiğinizden emin olun.
    • Haritanın ekranda görüneceği bir div öğesi bildirdiğinizden emin olun.
    • Haritaya ait 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.
    Referans uygulama için örneklerimize bakın.
  • Sorunların tespit edilmesine yardımcı olması için Chrome Geliştirici Araçları'nda bulunan gibi bir JavaScript hata ayıklayıcısı kullanın. JavaScript konsolunda hatalara bakarak başlayın.
  • Soruları Stack Overflow'da yayınlayın. Mükemmel soruları nasıl yayınlayacağınızla ilgili yönergeleri Destek sayfasında bulabilirsiniz.