Bu sayfa, Cloud Translation API ile çevrilmiştir.

Switch to English

Google Haritalar Platformu Hakkında SSS

Başlayın

Google Haritalar Platformu nedir?

Google Haritalar Platformu, geliştiricilerin Google Haritalar'ı mobil uygulamalara ve web sayfalarına yerleştirmelerine veya Google Haritalar'dan veri almalarına olanak tanıyan bir API ve SDK kümesidir. Birkaç teklif vardır. İhtiyaçlarınıza bağlı olarak, aşağıdaki API ve SDK'lardan birini veya birkaçını kullanabilirsiniz:

Haritalar:

Rotalar:

Yerler:

Ortam:

Google Haritalar Platformu'nu kullanmaya nasıl başlarım?

Google Haritalar Platformu'nu Kullanmaya Başlama başlıklı makaleyi inceleyin.

Hangi API'ye ihtiyacım var?

İşlevsel gereksinimlerinize göre doğru API'yi bulma konusunda yardım almak için API seçiciye göz atın.

Sitemdeki API'ları kullanmaya nasıl başlayabilirim?

İlgilendiğiniz API veya SDK için Genel Bakış, Geliştirici ve Başlangıç kılavuzlarına göz atın. Örneğin, Android için Haritalar SDK'sı veya Haritalar JavaScript API'si kılavuzlarına göz atın.

Google Haritalar Platformu hangi ülkeleri kapsar?

Google Haritalar ekibi, sürekli olarak yeni harita verileri aktarıyor ve uluslararası kapsamımızı genişletiyor. En güncel kapsam bilgileri için Google Haritalar kapsam verilerine bakın. Sayfanın üst kısmındaki filtre kutusuyla verileri filtreleyebilirsiniz. Veri sağlayıcılarıyla yapılan lisans sözleşmelerinin değişmesi durumunda kapsam verilerinin de değişebileceğini lütfen unutmayın.

Ayrıca bkz.:

Google Haritalar Platformu ürünlerinin İngilizce dışında bir dilde görüntülenmesini nasıl sağlayabilirim?
Toplu taşıma yol tarifleri hangi ülkelerde kullanılabilir?

Google Haritalar Platformu ürünlerini kullanmadan Google Haritalar'ı siteme yerleştirebilir miyim?

Evet. Google Haritalar artık, görüntülediğiniz haritayı Google Haritalar Platformu'nu herhangi bir programlama veya kullanım gerekmeden web sitenize veya blogunuza yerleştirme imkanı sunuyor. Buradan daha fazla bilgi edinebilirsiniz.

Haritalar uygulamalarını mobil cihazlarda nasıl sunabilirim?

Haritaları bir Android uygulamasına eklemek için Android için Haritalar SDK'sını kullanın.

Haritaları yerel bir iOS uygulamasına eklemek için iOS için Haritalar SDK'sını kullanın.

Haritalar JavaScript API, mobil cihazların ihtiyaçlarını karşılamak üzere geliştirilmiştir ve hem masaüstü bilgisayarları hem de Apple iPhone gibi tam JavaScript uygulamasına sahip bir web tarayıcısı içeren cihazları hedefleyen tarayıcı uygulamaları için uygundur.

Haritalar Statik API'si, Maps JavaScript API'nin kullanımına uygun olmayan cihazları hedefleyen uygulamalar için işaretçiler ve çoklu çizgiler dahil olmak üzere GIF, JPG ve PNG biçimlerinde harita resimleri sunar. Maps Static API'nin tarayıcı tabanlı uygulamalar dışında kullanılabilmesi için harita resminin Google Haritalar'a bağlı olması gerektiğini unutmayın.

Maps JavaScript API ve Maps Embed API hangi web tarayıcılarını destekler?

Maps JavaScript API ve Maps Embed API, şu web tarayıcılarını destekler:

Masaüstü

IE modu hariç, Microsoft Edge'in (Windows) geçerli sürümü.
Firefox'un en son iki önemli kararlı sürümü (Windows, macOS, Linux).
Chrome'un en son iki önemli kararlı sürümü (Windows, macOS, Linux).
Safari'nin (macOS) en son iki önemli kararlı sürümü.

Android

Android 4.1 ve sonraki sürümlerde Chrome'un geçerli sürümü.
Android 4.4 ve sonraki sürümlerde Chrome Web Görünümü.

iOS

iOS'in mevcut ve önceki ana sürümlerinde Mobil Safari.
iOS'in mevcut ve önceki ana sürümlerinde UIWebView ve WKWebView.
iOS için Chrome'un mevcut sürümü.

Maps JavaScript API'den harita yazdırabilir miyim?

Maps JavaScript API'den yazdırma işlemi desteklenmemektedir. Bunun nedeni, yazdırma desteğinin yaygın olarak kullanılan tarayıcılar arasında tutarsız olmasıdır.

Google Haritalar Platformu ürünlerinde değişiklik olduğunda nasıl bilgilendirilebilirim?

Çeşitli Google Coğrafi geliştirici teklifleriyle ilgili haber güncellemeleri için Google Haritalar Platformu Blogu'na abone olmanız gerekir.

Teknik destekle nasıl iletişime geçebilirim?

Kullanılabilir destek seçenekleri hakkında bilgi için Google Haritalar Platformu Desteği ve Kaynakları'na bakın.

Teknik destek ne zaman sunulacak?

Destek ekibi, "hizmet kullanılamıyor" sorunları nedeniyle bölgesel tatiller hariç, hafta içi her gün 09:00-17:00 (Pasifik saati) arasında 24 saat hizmet vermektedir.

Google Hesabıma erişimi nasıl kurtarabilirim?

Google Hesabınıza erişimi kaybettiyseniz (ör. ali@sirketim.com veya ali@gmail.com) şifrenizi geri alarak veya sıfırlayarak hesap erişimini geri yüklemeyi deneyebilirsiniz. Google Hesabı Yardım'da Google Hesabınızı veya Gmail'inizi kurtarma başlıklı makaleyi inceleyin.

Not: Bir G Suite hesabına tekrar erişim kazanmak için Kuruluş yöneticinizden hesabı silme işlemini geri almasını isteyin.

Belirli bir projeye erişimi nasıl kurtarabilirim?

Google Haritalar Platformu uygulamanızı yönettiğiniz projeye erişiminizi kaybettiyseniz projeyi kurtarmayı deneyebilirsiniz.

Projeyle ilişkili Google Hesabınıza erişiminiz varsa:

Proje Sahibini tanıyorsanız ve Google Hesabınıza erişebiliyorsanız: Proje Sahibinden sizi Proje Sahibi veya Proje Düzenleyici olarak eklemesini isteyin.
- Projeniz bir Kuruluşun parçasıysa: Kuruluş yöneticilerinizle iletişime geçerek sizi Proje Sahibi olarak eklemelerini isteyin.
Mevcut Proje Sahiplerinden hiçbirini tanımıyorsanız: Proje Sahibi'nin kim olduğunu bilmiyorsanız veya Proje Sahibi müsait değilse projeyi kurtarabileceğiniz ek seçenekleri öğrenmek için destek ekibiyle iletişime geçin.

Projeyle ilişkili Google Hesabınıza erişiminiz yoksa:

Google Hesabınıza erişemiyorsanız: Hesabınızın kullanıcı adını veya şifresini kurtarmayı deneyin.
Google Hesabınıza erişimi kurtaramazsanız: Yeni bir Google Hesabı oluşturun, ardından mevcut bir proje sahibiyle iletişime geçin ve yeni Google Hesabınızı projeye eklemesini isteyin.

Arm tabanlı Mac'lerde iOS için Haritalar ve Yerler SDK'sını kullanabilir miyim?

Yeni Arm tabanlı Mac'lerde geliştirme yapılabilir ancak bunun için fiziksel bir iOS cihazda geliştirme ve çalıştırma gerekir. Simülasyon araçlarında geliştirme için daha fazla destek sunmayı araştırdığımız bu süreçte, geçici bir sınırlama söz konusu.

Hizmet şartlarını anlama

Google Haritalar Platformu ürünleri için hizmet şartları nelerdir?

Google Haritalar Platformu Hizmet Şartları'na şu adresten ulaşabilirsiniz:

https://cloud.google.com/maps-platform/terms

Sitem Google Haritalar Platformu Hizmet Şartları'na uyuyor mu?

Siteniz Google Haritalar Platformu Hizmet Şartları'na uygun olduğu sürece uygulamalarınızda Google Haritalar Platformu'nu kullanabilirsiniz.

Bununla birlikte, Google Haritalar Platformu'nun görmek istemediğimiz bazı kullanımları da var: örneğin, bir şehirde yasa dışı uyuşturucu satın alınacak yerleri veya diğer yasa dışı faaliyetleri tanımlayan haritalar. Kişilerin gizliliğine de saygı duyarız. Bu nedenle, Google Haritalar Platformu bireyler hakkındaki özel bilgileri tanımlamak için kullanılmamalıdır.

Uygulamanızı geliştirip kullanıma sunmadan önce, uygulamanızın Google Haritalar Platformu Hizmet Şartları'na uygun olup olmadığını belirlemek için kendi danışmanınıza başvurmalısınız. Google mühendisleri yalnızca teknik yardım sunabilir ve hukuki tavsiyede bulunacak niteliklere sahip değildir. Google, hizmet kullanımınızı istediği zaman askıya alma veya sonlandırma hakkını saklı tutar. Bu nedenle, lütfen Haritalar API'leri Şartları'nı dikkatlice okuyun.

Harita desenlerine ve uydu görüntülerine doğrudan erişebilir miyim?

Harita karolarına veya uydu görüntülerine Google Haritalar Platformu haricindeki herhangi bir mekanizma üzerinden (kendi harita oluşturma API'nizin oluşturulması veya toplu karo indirme komut dosyası kullanılması) izin verilmez. Uygulamanızın kartlara Google Haritalar Platformu dışından erişmesi durumunda bu kartlara erişimi engellenir. Daha fazla bilgi için Google Haritalar Platformu Hizmet Şartları'na göz atın.

İzleme uygulamaları için Google Haritalar Platformu ürünlerini kullanabilir miyim?

Uygulamanın Google Haritalar Platformu Hizmet Şartları'na uyması koşuluyla, Google Haritalar Platformu ürünlerinde gerçek zamanlı verilerin (izleme) görüntülenmesiyle ilgili hiçbir kısıtlama yoktur.

Google Haritalar'ı web dışı uygulamamda kullanabilir miyim?

Evet, Google Haritalar Platformu ürünleri artık Google Haritalar Platformu Hizmet Şartları'nın diğer kısıtlamalarına uymaları koşuluyla web dışı uygulamalarda kullanılabilir.

Maps JavaScript API yalnızca desteklenen tarayıcılardan birinde çalıştırıldığında desteklenir.

Google Haritalar Platformu ürünlerini şifre korumalı bir sitede kullanabilir miyim?

Evet, Google Haritalar, Rotalar, Yerler ve Çevre hizmetleri özel erişim uygulamalarıyla kullanılabilir. Daha fazla bilgi için Google Haritalar Platformu Hizmet Şartları'na bakın.

Bir dokümanda Google Haritalar Platformu verilerini içeren bir uygulama oluşturabilir miyim?

Uygulamanız elektronik veya basılı biçimde belge oluşturuyorsa Google Haritalar Platformu'ndan gelen veriler (resimler dahil) dokümana dahil edilemez. Daha fazla bilgi için lütfen Google Haritalar Platformu Hizmet Şartları "Kazıma Yok" bölümüne bakın.

İçeriğimi Google arama sonuçlarına dahil etmemeyi nasıl seçebilirim?

Artık bu verileri toplamıyoruz. indexing parametresinin kullanımı kullanımdan kaldırılmıştır ve hiçbir etkisi yoktur. Artık açık bir şekilde devre dışı bırakmanız gerekmez ancak en kısa sürede bu parametreyi kaldırmanızı öneririz.

Sayfanızı veya sitenizi arama sonuçlarından kaldırmak için web yöneticisi yardım merkezimizde sağlanan talimatları uygulayın.

Web sitemde depoladığım ve sunduğum Maps Static API'yi kullanarak harita görüntüsü oluşturabilir miyim?

Web sitenizde Maps Static API kullanılarak oluşturulan resimlerin kopyalarını saklayamaz ve yayınlayamazsınız. Statik resim gerektiren tüm web sayfaları, HTML img etiketinin src özelliğini veya HTML div etiketinin CSS background-image özelliğini doğrudan Maps Static API'ye bağlamalıdır. Bu sayede, tüm harita resimleri web sayfasının HTML içeriğinde gösterilir ve Google tarafından doğrudan son kullanıcılara sunulur.

Kullanım sınırları ve faturalandırma

Projem için faturalandırmayı nasıl ayarlayabilirim?

Google Haritalar Platformu'nu Kullanmaya Başlama başlıklı makaleyi inceleyin.

Google Cloud Platform Ücretsiz Katman müşterileri nasıl ücretli hesaba yükseltme yapar?

Google Cloud Platform Ücretsiz Katman programı, müşterilere Google Haritalar Platformu (GMP) API'leri dahil herhangi bir Google Cloud Platform (GCP) hizmetiyle kullanılabilecek 300 ABD doları değerinde krediyle ücretsiz bir deneme sürümü sunar. Ücretsiz deneme süresi sona erdiğinde bu hizmetleri kullanmaya devam etmek için ücretli hesaba yükseltme yapmanız gerekir. Ücretli hesaba yükseltmek için Cloud Console'u ziyaret edin.

Google Haritalar Platformu'nun kullanım sınırları var mı?

Google Haritalar Platformu ürünlerine gönderebileceğiniz isteklerin sayısıyla ilgili maksimum günlük sınır yoktur ve kullanım sınırları yalnızca saniyedeki maksimum sorgu (QPS) veya dakika başına sorgu (QPM) sayısıyla ilgilidir.

Mesafe Matrisi için sınır, istemci taraflı ve sunucu tarafındaki sorguların toplamı olarak hesaplanan, saniyedeki etkinlik sayısı (EPS) cinsinden ayarlanır.

Rotalar:İşlem Rota Matrisi için sınır, dakika başına öğe (EPM) cinsinden belirtilir. Bir istekteki öğe sayısı, şuna eşittir: (kaynak sayısı × hedef sayısı).

Aşağıdaki tabloda, her API için kullanım sınırı gösterilmektedir.

API	Kullanım sınırı
Adres Doğrulama	Dakika Başına 6.000 Sorgu (QPM)
Havadan Görünüm: Arama Videosu	180 QPM ve 100.000 QPD
Havadan Görünüm: Video Oluşturma	100 QPM ve 100 QPD
Hava Kalitesi	Dakika Başına 6.000 Sorgu (QPM)
Yol tarifi	Dakika Başına 3.000 Sorgu (QPM)
Mesafe Matrisi	60.000 TRY
Dinamik Haritalar	30.000 QPM
Rakım	Dakika Başına 6.000 Sorgu (QPM)
Coğrafi Kodlama	Dakika Başına 3.000 Sorgu (QPM)
Coğrafi konum	Dakika Başına 6.000 Sorgu (QPM)
Yerler	Dakika Başına 6.000 Sorgu (QPM)
yollar	Dakika Başına 30.000 Sorgu
Rotalar: İşlem Rotaları	Dakika Başına 3.000 Sorgu (QPM)
Rotalar: Compute Rota Matrisi	3.000 TRY
Güneş enerjisine bağlı	Dakika Başına 600 Sorgu (QPM)
Statik Haritalar	Dakika Başına 30.000 Sorgu
Street View Image API	Dakika Başına 30.000 Sorgu
Saat Dilimi	Dakika Başına 30.000 Sorgu

Harcamalarınızı yönetmek için API kullanımınızı izleyebilir ve faturalandırılabilir API'lere yapılan tüm istekler için günlük sınırlar belirleyebilirsiniz.

Google Haritalar Platformu ürünleri, standart Google Haritalar Platformu Hizmet Şartları'na uygun olarak dağıtılmalıdır.

Kullanım maliyeti nasıl hesaplanır?

Google Haritalar Platformu ürünlerinin fiyatlandırmasına genel bakış için lütfen Fiyatlandırma Tablosu'na bakın.

Google Haritalar Platformu API'lerinin nasıl faturalandırıldığı hakkında daha fazla bilgi edinmek için lütfen Haritalar, Rotalar, Yerler ve Ortam için faturalandırmayı anlama makalesine göz atın.

Google Haritalar Platformu'nda harita yükleri nasıl sayılır?

Aşağıdakilerden herhangi biri gerçekleştiğinde tek bir harita yüklemesi için ücret alınır:

Bir web sayfası veya uygulama, Maps JavaScript API'yi kullanan bir haritayı görüntüler.
Bir uygulama, Maps Static API'den tek bir harita resmi ister.

Street View panoramaları, harita yüklemelerinden ayrı olarak ücretlendirilir:

Statik (etkileşimsiz) bir Street View panoraması yerleştirmek için Street View Static API'ye yapılan her istek için statik bir Street View panoraması ücretlendirilir.
Dinamik Street View panoraması; Maps JavaScript API, Android için Haritalar SDK'sı veya iOS uygulaması için Haritalar SDK'sındaki bir panorama nesnesinin her örneklendirmesi karşılığında ücretlendirilir.

Bir web sayfası veya uygulama bir harita, statik harita resmi ya da Street View panoraması yükledikten sonra, kullanıcıların bunlarla etkileşimleri (ör. kaydırma, yakınlaştırma veya harita katmanlarını değiştirme) ek harita yükleri oluşturmaz veya kullanım sınırlarını etkilemez.

İşaretçi eklemek ek harita yükleri oluşturmaz ancak raptiye konumunun nasıl belirlendiğiyle ilgili (ör. "google.maps.Map()" sınıfının yüklenmesi veya yeniden yüklenmesi gibi) ücret alınmasına neden olabilir.

Kullanımımı nasıl izleyebilirim?

Google Cloud Console'da API'lerin kullanımını ayrı ayrı izleyebilirsiniz.

İncelemek istediğiniz API'yi içeren projeyi seçin.
Kontrol Paneli'ndeki API listesinde API'nin adını tıklayın.
Sayfanın üst kısmına yakın bir yerde Metrikler veya Kotalar'ı tıklayın.

Bir projenin tamamı için trafik raporunu ve fatura bilgilerini görmek üzere şu adımları uygulayın:

Henüz yapmadıysanız faturalandırma ayarlarını yapın.
Cloud Console faturalandırma sayfasına gidin.
Proje seçin.
Sol kenar çubuğunda Raporlar'ı tıklayın. Faturalandırma hesabınızla ilgili raporları görüntülemek için sağ kenar çubuğundaki filtreleri kullanın.

Daha fazla bilgi edinmek için Google Haritalar Platformu Raporlaması'nın yanı sıra API Kullanımınızı İzleme ve API Kullanımını Sınırlama bölümlerine göz atın.

İstek oranı (QPS) sınırlarını aşarsam ne olur?

Belirli bir Google Haritalar Platformu ürününün QPS sınırlarını aşarsanız API bir hata mesajı döndürür. Sınırları tekrar tekrar aşmanız durumunda API'ye erişiminiz geçici olarak engellenebilir.

QPS sınırlarını aşarsa veya hizmeti başka bir şekilde kötüye kullanırsanız istekler belirli bir hata mesajı döndürür. Sınırları aşmaya devam ederseniz Google Haritalar Platformu'na erişiminiz engellenebilir.

Not: Dört web hizmeti API'sinin, Maps JavaScript API'de eşdeğer bir istemci tarafı hizmeti vardır: Directions, Mesafe Matix, Elevation ve GeoCode.

Kullanım sınırları aşıldı

Kullanım sınırlarını aşarsanız yanıt olarak bir OVER_QUERY_LIMIT durum kodu alırsınız.

Bu durumda, web hizmeti normal yanıtlar vermeyi durdurur ve tekrar daha fazla kullanıma izin verilene kadar yalnızca OVER_QUERY_LIMIT durum kodunu döndürmeye başlar. Uygulamanız saniyede çok fazla istek gönderdiği için hata aldıysanız bu durum birkaç saniye içinde gerçekleşebilir.

QPS kullanım sınırlarınızı düzenli olarak aşarsanız uygulamaları Google Haritalar Platformu ürünlerini daha verimli bir şekilde kullanacak şekilde optimize ederek kullanımı azaltmanız önerilir. Daha fazla bilgi için Optimizasyon Rehberi'ni inceleyin.

Sitem çok fazla trafik alıyor. Google Haritalar Platformu ürünlerini kullanabilir miyim?

Evet. Bununla birlikte, uygulamanızın kullandığı tüm Google Haritalar Platformu kullanım sınırları hakkında bilgi sahibi olmanızı öneririz.

Web sitem veya uygulamam aniden popüler hale gelirse haritalarım çalışmayı durdurur mu?

Bir faturalandırma hesabınız olduğunda, ücretsiz, aylık 200 ABD doları kullanım sınırını aşarsanız ve faturalandırma hesabınızda geçerli bir ödeme yönteminiz yoksa (kredi kartı, banka havalesi vb.) geçerli bir ödeme yöntemi eklenene kadar API çalışmaz.

Kullanım nasıl hesaplanıp faturalandırılacak?

Kullanım her günün sonunda hesaplanır ve Fiyatlandırma Tablosu'nda gösterildiği şekilde fiyatlandırılır. Her ayın sonunda toplam kullanım ücreti, faturalandırma hesabınızla ilişkili ödeme yönteminden alınır. Daha fazla bilgi için Google Haritalar Platformu Faturalandırması'na göz atın.

Google Haritalar Platformu'nu kullanmanın maliyeti nedir?

API başına maliyete genel bakış için Fiyatlandırma Tablosu'na bakın. Uygulamanız aylık 200 ABD dolarına kadar istek veya harita yükü hacmi oluşturursa kullanımınız ücretlendirilmez. Aylık 200 ABD dolarını aşan kullanımlar için faturalandırma hesabınız tahsil edilir. Daha fazla bilgi için Google Haritalar Platformu faturalandırmasını anlama kılavuzumuzu inceleyin.

Diğer para birimlerinde fiyatlandırma var mı?

Konsolda kullanılabilecek başka para birimleri de bulunmaktadır. Farklı bir para birimi seçtiğinizde fiyatlar, Fiyatlandırma E-Tablomuzda listelenen ABD doları eşdeğerine dönüştürülecektir.

Faturalandırma ayarlarını yaptım. Faturamı nasıl görüntüleyebilirim?

Google, her ayın başında belirttiğiniz ödeme yöntemini kullanarak bir önceki ayın etkinliği için sizden ödeme alır. Faturanızla ilgili ayrıntılar için Google Haritalar Platformu faturalandırmasını anlama kılavuzumuzu inceleyin.

Ek kaynaklar:

Maliyet ve ödeme geçmişinizi nasıl görüntüleyeceğinizi öğrenin.
Fatura veya ödeme makbuzunu nasıl alacağınızı öğrenin.
Faturalandırma uyarılarını nasıl ayarlayacağınızı ve yöneteceğinizi öğrenin.

Kullanımım beklenmeyen şekilde artarsa yüklü faturalardan nasıl kaçınabilirim?

Google Haritalar Platformu, günlük istek sınırları ve maksimum günlük faturalandırılabilir sınırlar belirlemenin yollarını sunar. Beklenmedik artışlardan kaçınmak için kullanımla ilgili maksimum günlük sınırı koyabilirsiniz. Ayrıca, faturalandırma hesabındaki ücretler belirlediğiniz bir eşiğe ulaştığında e-posta bildirimleri alacak şekilde bütçe uyarıları da ayarlayabilirsiniz.

Günlük maksimum faturalandırılabilir sınırı sınırlama:

Faturanın yüksek olmasını önlemek için kullanımdaki beklenmedik artışları önlemek amacıyla kullanım için günlük sınır belirleyebilirsiniz. Aşağıdaki adımları uygulayarak Cloud Console'da bu sınırı değiştirebilirsiniz:

API'ler ve Hizmetler Kontrol Paneli'ne gidin.
İstenirse bir proje seçin.
Listeden bir API seçin ve ardından Kotalar sekmesini tıklayın.
"Günlük istek sayısı" kotasının yanındaki düzenle simgesini tıklayın.

Alternatif olarak, IAM ve Yönetici Kotaları kontrol panelini kullanarak birden fazla API için birden fazla kotayı düzenleyebilirsiniz.

Bütçe uyarılarını ayarlama ve yönetme:

Faturalandırma hesabındaki ücretler ayarladığınız bir eşiğe ulaştığında faturalandırma yöneticilerine e-posta bildirimleri göndermek için bütçe uyarıları oluşturun. Faturalandırma hesabındaki tahmini ücretler, eşiğin %50, %90 ve% 100'ünü aştığında faturalandırma yöneticilerine e-posta bildirimi gönderilir.

Projemin "Google Haritalar Platformu Geçiş Hesabı"na bağlı olduğunu belirten bir mesaj aldım ancak bu hesaba erişimim yok. Ne yapmalıyım?

"Google Haritalar Platformu Geçiş Hesabı", belirli müşterilerin yeni kullandıkça öde fiyatlandırma planımıza geçiş yapmasına yardımcı olmak için oluşturulmuştur. Bu geçiş hesabı, Google'ın bu müşterilere tek seferlik bir kredi vermesini sağladı. Böylece müşteriler 200 ABD doları değerindeki ücretsiz katmana kadar Google Haritalar Platformu'nu kullanmaya devam edebilir. Bu sınır aşıldığında faturalandırma hesabı kapatılır ve hizmete erişimi kaybedersiniz. Hizmet kesintisi yaşamamak için kendi faturalandırma hesabınızı ayarlamanızı ve 200 ABD doları değerindeki aylık ücretsiz katmandan yararlanmaya devam etmenizi öneririz. Projenize ait faturalandırma hesabını değiştirmek için:

Yeni bir faturalandırma hesabı oluşturun (Zaten faturalandırma hesabınız varsa bu adımı atlayabilirsiniz).
Faturalandırma hesabını projenizle ilişkilendirin.

Kota sınırım neden günde 1 istek olarak ayarlı? Limitimi nasıl artırabilirim?

Faturalandırma hesabı oluşturup projenize eklemediyseniz Maps Platform API'leriniz günlük 1 istekle sınırlandırılır. Bir faturalandırma hesabı oluşturup ekleyerek daha yüksek kotaya sahip olabilirsiniz. Bunu yapmak için Google Haritalar Platformu'nu Kullanmaya Başlama başlıklı makaleyi inceleyin.

Faturalandırma hesabı oluşturup ekledikten sonra günlük kota sınırınız kaldırılır. Cloud Console'da beklenmedik harcamaları önlemek için sınır belirlemeye karar verebilirsiniz.

Bir faturalandırma ihlali bildirimi aldım. Bu sorunu nasıl çözebilirim?

Bu bildirim, Google'ın, hesabınızda birden fazla faturalandırma hesabı kullanıldığını belirlediği için gönderilmiştir. Bu durum, Google Haritalar Platformu Hizmet Şartları'nın 3.2.4 bölümünde tanımlanan Google şartlarının ihlali anlamına gelir. Bu şartlar kapsamında, birden fazla faturalandırma hesabı oluşturmak yasaktır. Daha fazla bilgi edinmek için Faturalandırma Hesabı İhlaliyle İlgili SSS sayfasına bakın.

Google Haritalar Platformu'nu kullanma

Farklı Haritalar ürünleri için hangi anahtarları veya kimlik bilgilerini kullanmalıyım?

Google Haritalar Platformu ürünlerini her kullandığınızda, isteğinizi doğrulamak için bir API anahtarı eklemeniz gerekir. Google Haritalar Platformu Android, iOS veya web uygulamaları için ve HTTP web hizmetleri üzerinden kullanılabilir.

API Anahtarı:

API anahtarı, Cloud Console kullanarak oluşturduğunuz benzersiz bir tanımlayıcıdır.
Anahtarla API yükleme örneği: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Dijital İmza:

Dijital imza, Google tarafından size sağlanan bir URL imzalama gizli anahtarı kullanılarak oluşturulur. Dijital imzalar, Maps Static API ve Street View Static API ile birlikte kullanılır.

Kısıtlamalar:

API anahtarı kısıtlamaları isteğe bağlıdır ancak daha fazla güvenlik için tüm API anahtarlarını kısıtlamanızı önemle tavsiye ederiz. Daha fazla bilgi için API güvenliği en iyi uygulamalarına göz atın.
API anahtarına bir uygulama kısıtlaması ekleyebilirsiniz. Kısıtlanan anahtarlar yalnızca söz konusu kısıtlama türünü destekleyen platformlarda çalışır. Dört tür uygulama kısıtlaması vardır. Aynı kısıtlama türünü uygulayan API'ler aynı kısıtlanmış anahtarı kullanabilir.
- IP adresleri (bağımsız sunucular): Web hizmeti API'leriyle birlikte kullanılır.
- HTTP yönlendirenleri (web siteleri) - Web API'leriyle birlikte kullanılır.
- Android uygulama kısıtlaması (paket adına ve parmak izine göre) - Android için Haritalar SDK'sı ile birlikte kullanılabilir.
- iOS uygulama kısıtlaması (iOS paket tanımlayıcısına göre) - iOS için Haritalar SDK'sı ile birlikte kullanılır.
API anahtarına bir API kısıtlaması da ekleyebilirsiniz. Daha fazla bilgi için API anahtarı alma, ekleme ve kısıtlama başlıklı makaleyi inceleyin.

Aşağıdaki tabloda, her bir Google Haritalar Platformu API/SDK'sı için anahtar/kimlik bilgisi ve uygulama kısıtlaması gösterilmektedir.

API/SDK	Kimlik Bilgisi ve Uygulama Kısıtlaması
Android için Haritalar SDK'sı	Android kısıtlaması olan API anahtarı¹
Android için Yerler SDK'sı	Android kısıtlaması olan API anahtarı¹
iOS için Haritalar SDK'sı	iOS kısıtlaması olan API anahtarı¹
iOS için Yerler SDK'sı	iOS kısıtlaması olan API anahtarı¹
Maps JavaScript API	HTTP yönlendiren kısıtlamalı API anahtarı¹
Aerial View API	IP adresi kısıtlamalı API anahtarı¹
Maps Static API	HTTP yönlendiren kısıtlaması olan API anahtarı¹ + Dijital İmza²
Street View Static API	HTTP yönlendiren kısıtlaması olan API anahtarı¹ + Dijital İmza²
Maps Embed API	HTTP yönlendiren kısıtlamalı API anahtarı¹
Address Validation API (Adres Doğrulama API'si)	IP adresi kısıtlamalı API anahtarı¹
Directions API	IP adresi kısıtlamalı API anahtarı¹
Mesafe Matrisi API'si	IP adresi kısıtlamalı API anahtarı¹
Elevation API	IP adresi kısıtlamalı API anahtarı¹
GeoKodlama API'si	IP adresi kısıtlamalı API anahtarı¹
Geolocation API	IP adresi kısıtlamalı API anahtarı¹
Places API	IP adresi kısıtlamalı API anahtarı¹
Roads API	IP adresi kısıtlamalı API anahtarı¹
Routes API	IP adresi kısıtlamalı API anahtarı¹
Time Zone API	IP adresi kısıtlamalı API anahtarı¹
Air Quality API	IP adresi kısıtlamalı API anahtarı¹
Solar API	IP adresi kısıtlamalı API anahtarı¹

¹ API anahtarı kısıtlamaları isteğe bağlıdır ancak daha fazla güvenlik için tüm API anahtarlarını kısıtlamanızı önemle tavsiye ederiz.

² Kullanıma bağlı olarak, Haritalar Static API ve Street View Static API için dijital imza gerekebilir. Kullanımdan bağımsız olarak, isteklerinizin kimliğini doğrulamak için hem API anahtarı hem de dijital imza kullanmanızı önemle tavsiye ederiz.

Anahtar kısıtlama türümü bir HTTP yönlendirenden IP adresi kısıtlamasına nasıl geçirebilirim?

Önemli: Yönlendiren kısıtlamaları olan bir API anahtarıyla web hizmeti API'lerinden herhangi birini kullanıyorsanız istekleriniz şu hata mesajını vererek başarısız olur: "API anahtarları, bu API ile birlikte kullanıldığında başvuran kısıtlamalarına sahip olamaz." IP adresi kısıtlamaları olan bir API anahtarı kullanmaya geçmelisiniz.

API anahtarı kısıtlama türünü HTTP yönlendiricisinden IP adresine geçirmeden önce, API anahtarını kullanan tüm API'lerin IP kısıtlama türünü desteklediğinden emin olun. Aynı kısıtlama türündeki API'ler aynı kısıtlanmış anahtarı kullanabilir. Birden fazla kısıtlamayı zorunlu kılmanız gerekiyorsa gerekli kısıtlamaya sahip ayrı bir anahtar ekleyin. Yeni bir API anahtarının nasıl ekleneceğini öğrenin.

Google Haritalar Platformu ürünleriyle ilişkili API anahtarı kısıtlamaları hakkında daha fazla bilgi edinin.

HTTP yönlendiricisi kısıtlaması olan bir API anahtarını IP adresi kısıtlamasıyla değiştirmek için aşağıdakileri yapın:

Cloud Console'un Kimlik bilgileri sayfasına gidin.
Düzenlemek istediğiniz API anahtarını içeren projeyi seçin.
Kimlik bilgileri sayfasında, anahtar ayrıntılarını düzenlemek için API anahtarları listesinden API anahtarının adını seçin.
Sayfanın Anahtar kısıtlaması bölümünde, "IP adresleri (web sunucuları, cron işleri vb.)" seçeneğini belirleyin, uygun sunucu IP adreslerini girin ve Kaydet'i tıklayın.

Nasıl yeni bir API anahtarı edinebilirim?

Google Haritalar Platformu'nu Kullanmaya Başlama başlıklı makaleyi inceleyin.

Google Haritalar API'lerinin her sürümünde yapılan değişiklikleri nasıl bulabilirim?

Birçok Google Haritalar API'sına ilişkin sürüm değişikliği bilgilerine aşağıdaki bağlantılardan ulaşabilirsiniz:

Ayrıca, Google Haritalar Platformu Sorun İzleyici'yi kullanarak belirli bir hatanın Google Haritalar Platformu'nun hangi sürümünde kullanıma sunulduğunu ve düzeltildiğini şu adresten kontrol edebilirsiniz:

https://issuetracker.google.com/bookmark-groups/76561

Sayfa yüklendikten sonra API'yı bir sayfaya eşzamansız olarak nasıl yükleyebilirim?

API'yi yüklerken geri çağırma parametresini belirtmeniz yeterlidir. Maps JavaScript API belgelerinin Başlarken bölümünde daha fazla bilgi ve örnek kod bulabilirsiniz.

Google Haritalar Platformu ürünlerinin İngilizce dışında bir dilde görüntülenmesini nasıl sağlayabilirim?

Varsayılan olarak API, kullanıcının konumuna veya tarayıcı ayarlarına göre en uygun dili yüklemeye çalışır. Bazı API'ler, istek yaptığınızda açıkça bir dil ayarlamanıza olanak tanır. Dilin nasıl ayarlanacağıyla ilgili daha fazla bilgiyi her API'nin belgelerinde bulabilirsiniz:

Desteklenen Diller:

Google, desteklenen dilleri sık sık günceller. Bu liste, tam kapsamlı olmayabilir ve değişebilir.

Dil Kodu	Dil	Dil Kodu	Dil
af	Afrikaanca	ja	Japonca
sq	Arnavutça	kn	Kannada dili
öö	Amharca	kk	Kazakça
ar	Arapça	km	Kmerce
hy	Ermenice	ko	Korece
az	Azerbaycan dili	ky	Kırgızca
eu	Bask dili	lo	Laoca
be	Belarusça	lv	Letonca
bn	Bengalce	lt	Litvanca
bs	Boşnakça	mk	Makedonca
bg	Bulgarca	ms	Malay dili
my	Burmaca	ml	Malayalamca
ca	Katalanca	mr	Marathi
zh	Çince	mn	Moğolca
zh-CN	Çince (Basitleştirilmiş)	ne	Nepalce
zh-HK	Çince (Hong Kong)	no	Norveççe
zh-TW	Çince (Geleneksel)	pl	Lehçe
s	Hırvatça	pt	Portekizce
cs	Çekçe	pt-BR	Portekizce (Brezilya)
da	Danca	pt-PT	Portekizce (Portekiz)
nl	Felemenkçe	pa	Pencap Dili
en	İngilizce	ro	Rumence
en-AU	İngilizce (Avustralya)	ru	Rusça
en-GB	İngilizce (İngiltere)	sr	Sırpça
et	Estonya Dili	si	Singalaca
fa	Farsça	sk	Slovakça
fi	Fince	sl	Slovence
fil	Filipince	es	İspanyolca
fr	Fransızca	es-419	İspanyolca (Latin Amerika)
fr-CA	Fransızca (Kanada)	sw	Swahili
gl	Galiçya Lehçesi	sv	İsveççe
ka	Gürcüce	ta	Tamilce
de	Almanca	te	Teluguca
el	Yunanca	th	Tayca
gu	Gucerat dili	tr	Türkçe
iw	İbranice	uk	Ukraynaca
hi	Hintçe	ur	Urduca
hu	Macarca	uz	Özbekçe
:	İzlandaca	vi	Vietnamca
id	Endonezce	zu	Zulu
it	İtalyanca

Haritanın yukarıda listelenen dillerden herhangi birinde nasıl görüneceğini bu örnek uygulamada görebilirsiniz.

Google Haritalar Platformu'na SSL (HTTPS) üzerinden erişilebilir mi?

Maps JavaScript API, Maps Static API ve Web Service API'lerine, güvenli (HTTPS) bağlantılar üzerinden erişilebilir. SSL üzerinden API'ye nasıl erişebileceğiniz hakkında bilgi edinmek için lütfen ilgili API'nin dokümanlarına bakın.

Maps Static API'nin HTTPS kullanan özel simge URL'lerini desteklemediğini, varsayılan simge görüntüleneceğini unutmayın.

Google Haritalar Platformu'nda nasıl hata bildirebilir veya yeni bir özellik isteğinde bulunabilirim?

Hata olabileceğini düşündüğünüz bir davranışla karşılaşırsanız lütfen önce ilgili forumda bu durumu bildirin. Bu sayede diğer geliştiriciler hatayı doğrulayabilir ve kodunuzla ilgili olası sorunları ortadan kaldırabilir.

Özellik talep etmek istiyorsanız lütfen öncelikle gereksinimlerinizi karşılayan bir çözümün mevcut olmadığını doğrulamak için özelliği ilgili forumda da iletin.

Yeni bir hata tanımladığınızı veya gereksinimlerinizin Google Haritalar Platformu ürünlerinin mevcut işlevleriyle karşılanamadığını onayladıktan sonra lütfen Google Haritalar Platformu Sorun İzleyici'yi kullanarak hata veya özellik isteğinizi bildirin.

Sorun İzleyici'ye hata veya özellik isteği eklemeden önce lütfen ilgili hatanın veya özelliğin zaten eklenmemiş olup olmadığını kontrol edin. Sorun varsa ilgilendiğinizi bildirmek ve güncellemelerden haberdar olmak için soruna yıldız ekleyebilirsiniz.

Google Haritalar Platformu API'leri site çerezlerini nasıl kullanıyor?

Android için Haritalar SDK'sı ve iOS için Haritalar SDK'sı, günlük ve 7 günlük etkin kullanıcı sayısının hesaplanması ve hizmetin kötüye kullanımını önleme gibi Google'ın Gizlilik Politikası'na tabi olan çerezleri kullanır. Bu çerezler, oturum açmış herhangi bir Google Hesabı ile ilişkilendirilmez ve API çağrılarından toplanan diğer bilgilerle birlikte günlüğe kaydedilmez.

Sorumun cevabını bulamıyorum. Kiminle iletişime geçmeliyim?

Google'ın Geliştirici İlişkileri ekibi, programcılar için işbirliği içinde düzenlenen bir soru-cevap sitesi olan Stack Overflow'da yer almaktadır. Burası, Google Haritalar uygulamalarının geliştirilmesi ve bakımı hakkında teknik sorular sormak için mükemmel bir yerdir. Stack Overflow hakkında soru sorma hakkında daha fazla bilgiyi Destek sayfasında bulabilirsiniz.

Yardım isterken en iyi sonuçları elde etmek için lütfen aşağıdakileri göz önünde bulundurun:

Mevcut tartışmalarda arama yapın. Büyük olasılıkla başka biri de benzer bir sorun yaşamış ve bir çözüm bulmuştur.
Mümkünse sitenize bir bağlantı gönderin. Kod snippet'lerini yalnızca kodun çevrimiçi olarak kolayca görüntülenememesi durumunda yayınlayın.
Tarayıcı sürümleri, hatalar ve bu sorunun giderilmesinde faydalı olabilecek diğer tüm bilgiler dahil olmak üzere ilgili tüm bilgileri sağlayın.

Hatalar ve sorun giderme

Bu hata ne anlama geliyor?

Google Haritalar API'lerini yüklerken veya çalıştırırken hatayla karşılaşırsanız hata kodlarının açıklamalarını görmek için lütfen aşağıdaki bağlantılara bakın:

Haritalarım normalden daha koyu görünüyor. Sorun nedir?

Belirli durumlarda, "yalnızca geliştirme amaçlı" metniyle filigranlı, koyu renkli bir harita veya "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 faturalandırma hesabınızın olması ve tüm isteklerin geçerli bir API anahtarı içermesi gerekir. Aşağıdaki akış, bu sorunu gidermenize yardımcı olur:

API anahtarı kullanıyor musunuz?

Emin değilim. API anahtarı kullanıp kullanmadığımı nasıl kontrol edebilirim?

Maps JavaScript API'yi yüklemek için kullanılan URL'de key parametresi olarak bir API anahtarı iletilir. API anahtarı kullanıp kullanmadığınızı kontrol etmek için yararlanabileceğiniz birkaç seçenek aşağıda verilmiştir:

Google Haritalar Platformu API Kontrolü Chrome uzantısını kullanın. Bu sayede, web sitenizin Google'ın lisanslı Haritalar API'lerini doğru bir şekilde uygulayıp uygulamadığını belirleyebilirsiniz.
Maps JavaScript API'yi yüklemek için kitaplık veya eklenti kullanıyorsanız söz konusu kitaplığın ayarlarını kontrol edin ve bir API anahtarı seçeneği arayın.
Tarayıcınızdaki hataları kontrol edin. Aşağıdaki mesajları görürseniz API anahtarınızı doğru şekilde kullanmıyorsunuz demektir:

Google Maps JavaScript API uyarısı: NoApiKeys
Google Haritalar JavaScript API hatası: EksikKeyMapError

Web geliştiricileri için:

Uygulamanızın kaynak koduna erişebiliyorsanız Maps JavaScript API'yi yüklemek için kullanılan <script> etiketini bulun. Maps JavaScript API'yi yüklerken, aşağıdaki koddaki YOUR_API_KEY yerine API anahtarınızla yerleştirin.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Tarayıcıda web siteniz tarafından oluşturulan ağ trafiğini kontrol edin. Chrome'da Geliştirici Araçları Ağ sekmesi kullanılarak görüntülenebilir. Burada, web siteniz tarafından yapılan ağ isteklerini görürsünüz. Maps JavaScript API kullanılarak yapılan istekler maps/api/js yolunda olacaktır. Burada isteklerin key parametresini kullanıp kullanmadığını kontrol edebilirsiniz. Ağ sekmesini görüntülerken ağ trafiğinizi maps/api/js ölçütüne göre filtrelemek yararlı olabilir.

Hayır, API anahtarı kullanmıyorum.

Bir API anahtarı almak için aşağıdaki düğmeyi tıklayın. Rehberli kurulum görmüyorsanız Google Haritalar Platformu'nu Kullanmaya Başlayın bölümündeki talimatların tamamını uygulayın.
Başlayın

Evet, API anahtarı kullanıyorum.

İsteğinizi aldık. Devam edelim ve projenize bir faturalandırma hesabı ekli olup olmadığını kontrol edelim.

Projenize bir faturalandırma hesabı eklenmiş mi?

Emin değilim. Faturalandırma hesabının projeme bağlı olup olmadığını nasıl kontrol edebilirim?

Google Cloud Console'da Faturalandırma sayfasına gidin ve API anahtarınızın altında oluşturulduğu projeyi seçin. Anahtarın projeyle ilişkilendirildiğini onaylamak için:

Google Haritalar Platformu > Kimlik Bilgileri altındaki sol kenar çubuğundan erişilebilen Credentials (Kimlik Bilgileri) bölümüne gidin.
Web sitenizde kullanmakta olduğunuz API anahtarının listede olup olmadığını kontrol edin. Bu mümkün değilse farklı bir projeye geçin ve kimlik bilgilerini orada kontrol edin.
API anahtarınıza ait projeyi bulamıyorsanız bu projeye erişiminizi kaybetmiş olabilirsiniz. Kuruluşunuzdaki diğer kişilerden yardım isteyin. Orijinal proje bulunamıyorsa şunları yapmalısınız:
1. Yeni proje oluşturun. Bu işlem, proje listesinden Yeni Proje'yi seçerek veya Resource Manager sayfasından Proje Oluştur'u seçerek yapılabilir.
2. Yeni bir API anahtarı oluşturma. Bu işlem Kimlik Bilgileri sayfasında yapılabilir. Bu sayfada Kimlik bilgileri oluştur'u tıklayın ve ardından API anahtarı'nı seçin.

Cloud Console'da projenizi bulduktan sonra sol taraftaki menüden Faturalandırma bölümüne giderek bir faturalandırma hesabı eklenip eklenmediğini kontrol edin.

Hayır, projeme faturalandırma hesabı bağlı değil.

Cloud Console'da Faturalandırmayı Etkinleştir sayfasına gidin ve projenize bir faturalandırma hesabı ekleyin. Daha fazla bilgi için Google Haritalar Platformu'nu Kullanmaya Başlama bölümüne bakın.

Evet, projeme bir faturalandırma hesabı ekli.

İsteğinizi aldık. Sağlanan faturalandırma yönteminin geçerli olduğundan emin olalım.

Sağlanan faturalandırma yöntemi artık geçerli değil mi (örneğin, süresi dolmuş bir kredi kartı)?

Cloud Console'da ödeme yöntemi ekleyebilir, kaldırabilir veya güncelleyebilirsiniz.

API'de, yükleyicinin uyguladığı günlük sınır aşılmış mı?

API'lerinizden herhangi birinde günlük sınır belirlediyseniz (genellikle beklenmedik artışları önlemek için), günlük sınırınızı artırarak bu sorunu çözebilirsiniz.

Günlük sınırlarınızı Cloud Console'daki API'ler ve Hizmetler Kontrol Paneli'ne giderek kontrol edebilirsiniz. Bu sayfaya ulaştığınızda:

İstenirse bir proje seçin.
Listeden bir API seçin ve ardından Kotalar sekmesini tıklayın.

API anahtarınızda IP adresi kısıtlaması var mı?

IP adresleri kısıtlaması olan API anahtarları, yalnızca sunucu tarafında kullanılması amaçlanan web hizmetleriyle (ör. GeoCode API ve diğer Web Hizmeti API'leri) kullanılabilir. Bu web hizmetlerinin çoğu, Maps JavaScript API'de eşdeğer hizmetlere sahiptir (örneğin, Coğrafi Kodlama Hizmeti'ne bakın). Maps JavaScript API istemci tarafı hizmetlerini kullanmak için HTTP yönlendirenleri kısıtlamasıyla güvence altına alınabilen ayrı bir API anahtarı oluşturmanız gerekir (bkz. API anahtarı alma, ekleme ve kısıtlama).

Hata kodlarını nasıl çözebilirim: OVER_DAILY_LIMIT veya OVER_QUERY_LIMIT?

Bu hata kodları, aşağıdaki nedenlerden herhangi biri nedeniyle döndürülebilir:

İstekte bir API anahtarı eksik.
Sağlanan API anahtarı geçersiz.
Projeye eklenmiş bir faturalandırma hesabı yok.
Kendi kendine uygulanan bir kullanım sınırı aşıldı.
Sağlanan ödeme yöntemi artık geçerli değil (örneğin, bir kredi kartının geçerlilik süresi dolmuş).
Belirli bir API için QPS sınırlarını aştınız.

Google Haritalar Platformu ürünlerini kullanmak için faturalandırma hesabınızın olması ve tüm isteklerin geçerli bir API anahtarı içermesi gerekir. Bunu düzeltmek için aşağıdaki adımları uygulayın:

Faturalandırma hesabı oluşturun.
Yeni bir API anahtarı alın.
Günlük sınırınızı yükseltmek için (geçerliyse) kullanım sınırınızı ayarlayın.

Hata kodlarını nasıl çözebilirim: kGMSPlacesRateLimitExceeded veya 9005 PLACES_API_RATE_LIMIT_EXCEEDED?

kGMSPlacesRateLimitExceeded veya 9005 PLACES_API_RATE_LIMIT_EXCEEDED öğelerini görüyorsanız Android için Yerler SDK'sının veya iOS için Yerler SDK'sının kullanımdan kaldırılmış bir sürümünü kullanıyor olabilirsiniz. https://goo.gle/place-sdk-deprecation adresinden daha fazla bilgi edinin ve yeni SDK'ları bulun.

"Bu IP, site veya mobil uygulamanın bu API anahtarını kullanma yetkisi yok." hatasını nasıl giderebilirim?

Bu hataya neden olabilecek çeşitli senaryolar vardır:

API anahtarınızda IP adresi (sunucu) kısıtlamalarını etkinleştirdiniz ve yetkisiz bir IP adresi istekte bulunmaya çalışıyor.
API anahtarınızda HTTP yönlendiren (web sitesi) kısıtlamalarını etkinleştirdiniz ve yetkisiz bir yönlendiren bir istekte bulunmaya çalışıyor.
Paket adı ve parmak izi ayarlayarak Android uygulamalarınızın kullanımını kısıtladınız ve yetkisiz bir Android uygulaması bir istekte bulunmaya çalışıyor.
Paket tanımlayıcıları belirterek iOS uygulamalarından gelen istekleri kısıtladınız ve tanınmayan bir iOS uygulaması istek göndermek için çalışıyor.
Eskiden web hizmeti API'lerinden herhangi birini, HTTP yönlendirici kısıtlamaları olan bir API anahtarıyla kullandıysanız bu hatayı alabilirsiniz. Bu API'lere yapılan istekler, IP adresi kısıtlamalarına sahip bir API anahtarıyla tanımlanmalıdır. Anahtar kısıtlama türünüzü HTTP yönlendiren kısıtlamasından IP adresi kısıtlamasına geçirin. API anahtarlarını kısıtlama hakkında daha fazla bilgi için API Anahtarı En İyi Uygulamaları bölümüne bakın.

API anahtarı kimlik bilgilerinizi görüntüleme ve düzenleme

API anahtarlarınızı görüntülemek ve kısıtlamaları yönetmek için aşağıdakileri yapın:

Cloud Console'un Kimlik bilgileri sayfasına gidin.
İncelemek istediğiniz API anahtarını içeren projeyi seçin.
Anahtar için ayarlanan kısıtlamalar da dahil olmak üzere kimlik bilgisi ayrıntılarını görüntülemek için API anahtarları listesinden anahtarın adını tıklayın.
Seçilen API anahtarının, anahtar için ayarlanan kısıtlamalar dahil olmak üzere tam kimlik bilgileri gösterilir. Buradan kısıtlamalar değiştirilebilir, silinebilir veya güncellenebilir.

"Yönlendiren kısıtlamaları olan API anahtarları bu API ile kullanılamaz" hatasını nasıl giderebilirim?

HTTP yönlendiricisiyle sınırlı bir API anahtarıyla web hizmeti API'lerinden herhangi birini kullanıyorsunuz. Güvenlik nedeniyle web hizmeti API'lerinin, IP adresleriyle kısıtlanmış API anahtarlarını kullanması gerekir. Anahtar kısıtlama türünüzü HTTP yönlendiren kısıtlamasından IP adresi kısıtlamasına geçirin veya anahtarınız zaten Maps JavaScript API ile kullanılıyorsa yeni bir API anahtarı oluşturun.

Google Haritalar Platformu Hizmetleri

Adresleri enlem/boylam çiftlerine dönüştürmem gerekiyor. Bu işlemi Google Haritalar Platformu ile yapabilir miyim?

Evet, bu işleme "coğrafi kodlama" denir. Maps JavaScript API, coğrafi kodlama hizmeti yürütmeye yönelik bir sınıf içerir. Sınıf: google.maps.Geocoder.

Alternatif olarak Google, JSON ve XML biçimlerinde yanıt verebilen bir REST arayüzü sunan Coğrafi Kodlama API'sini de sağlar.

Coğrafi kodlama hangi ülkelerde kullanılabiliyor?

Şu anda Google Haritalar Platformu coğrafi kodlayıcıları tarafından desteklenen ülkeleri görmek için lütfen Google Haritalar kapsam verilerine bakın.

Coğrafi kodlamalı konumların doğruluğu ülkeye göre değişebilir. Bu nedenle, uygulamanızın amaçları doğrultusunda yeterince iyi bir eşleşme bulunup bulunmadığını belirlemek için döndürülen location_type alanını kullanmanız gerekir. Coğrafi kodlama verilerinin kullanılabilirliğinin, veri sağlayıcılarla yaptığımız sözleşmelere bağlı olduğunu, bu nedenle değişebileceğini lütfen unutmayın.

Google Haritalar Platformu Coğrafi Kodlayıcıları neden Google Haritalar'dan farklı konumlar sağlıyor?

API coğrafi kodlayıcısı ve Google Haritalar coğrafi kodlayıcısı bazen farklı veri kümeleri kullanır (ülkeye bağlı olarak). API coğrafi kodlayıcısı zaman zaman yeni verilerle güncellenir. Bu nedenle, zaman içinde sonuçların değiştiğini veya iyileştiğini görebilirsiniz.

Başarılı istek sayısını en üst düzeye çıkarmak için coğrafi kodlayıcı sorgularımı nasıl biçimlendirmeliyim?

Coğrafi kodlayıcı, sokak adreslerini coğrafi koordinatlarla eşleştirmek için tasarlanmıştır. Bu nedenle, sorgunun başarılı olması olasılığını en üst düzeye çıkarmak için coğrafi kodlayıcı isteklerini aşağıdaki yönergelere göre biçimlendirmenizi öneririz:

Adresleri, ilgili ülkenin ulusal posta hizmeti tarafından kullanılan biçime uygun olarak belirtin.
İlgili ülkenin posta hizmeti tarafından tanımlandığı şekilde adrese dahil edilmeyen işletme adları, birim numaraları, kat numaraları veya daire numaraları gibi ek adres öğeleri belirtmeyin. Bunu yaparsanız ZERO_RESULTS ile yanıt verilebilir.
Artı kodlarını burada gösterildiği gibi biçimlendirin (artı işaretleri %2B öğesine, boşluklar için URL'den %20 öğesine çıkış yapılacak):
- global kod, 4 karakterli bir alan kodu ve 6 veya daha uzun bir yerel koddur (849VCWC8+R9, 849VCWC8%2BR9'dir).
- birleşik kod, konumu açıkça belirtilmiş 6 karakterli veya daha uzun bir yerel koddur (CWC8+R9 Mountain View, CA, ABD: CWC8%2BR9%20Mountain%20View%20CA%20USA).
Mümkünse bina adı yerine bina numarasını kullanın.
Mümkün olduğunda ara sokakları belirtmek yerine sokak numarası adresi vermeyi kullanın.
Yakındaki önemli noktalar gibi "ipuçları" vermeyin.

Coğrafi kodlama için ABD'deki bir adresi numaralı otoyol üzerinde nasıl biçimlendirmeliyim?

Google Haritalar Platformu coğrafi kodlayıcısı, ABD'deki numaralı otoyolların aşağıdaki gibi adreslerde belirtilmesini gerektirir:

İlçe Yolları: "Co Road NNN"; NNN, yol numarasıdır. Ör. "Co Road 82"
Eyalet Otoyolları: "State NNN" Burada Eyalet eyaletin tam adı, NNN ise otoyol numarasıdır. Ör. "California 82"
ABD Otoyolları: "U.S. NNN" NNN otoyol numarasıdır. ör. "U.S. 101"
ABD eyaletleri: "Interstate NNN"; NNN, eyaletler arası sayıdır. Ör. "Interstate 280"

Ne zaman API coğrafi kodlayıcı sınıfı ve HTTP Coğrafi Kodlama Hizmeti'ni ne zaman kullanmalıyım?

Farklı coğrafi kodlama stratejilerinin avantajlarını ve dezavantajlarını açıklayan Coğrafi Kodlama Stratejileri belgesini inceleyin.

Google Haritalar Platformu ile arabayla yol tariflerini nasıl veririm?

Routes API'nin Compute Routes hizmeti ve Directions API, tek ve çok ayaklı yolculuklar için arabayla yol tarifi sağlamanıza olanak tanır. Rota seçenekleri; ulaşım şekli (araba), tek veya bir dizi rota ve kısıtlamalar (paralı yollar yok) ile yol tariflerini şekillendirmenize yardımcı olur. Bu hizmetler aşağıdaki biçimlerde kullanılabilir:

HTTP istek/yanıt arayüzü (mobil ve diğer uygulamalarda kullanılır), Android için Haritalar SDK'sı ve diğer Google Haritalar web hizmetleriyle uyumludur.
İstemci tarafı uygulamalar için JavaScript API, google.maps.DirectionsService sınıfı aracılığıyla arabayla yol tarifleri sağlamanıza olanak tanır. DirectionsRenderer sınıfı yer paylaşımlarını ve yol tarifi panelini sizin için otomatik olarak oluşturabilir. Dokümanlarda ek örnekler verilmiştir.
Sunucu tarafı uygulamalar için Java, Python, go ve Node.js istemci arayüzleri aynı işlevi sağlar. İstemci kitaplıkları hakkında daha fazla bilgi için Directions API istemci kitaplıkları bölümüne bakın.

Arabayla yol tarifleri hangi ülkelerde kullanılabilir?

Google Haritalar Platformu ürünlerindeki arabayla yol tariflerinin şu anda desteklendiği ülkeleri görmek için Google Haritalar kapsam verilerine bakın. Arabayla yol tarifi verilerinin kullanılabilirliğinin, veri sağlayıcılarla yaptığımız sözleşmelere bağlı olduğunu ve değişebileceğini lütfen unutmayın.

Toplu taşıma yol tarifleri hangi ülkelerde kullanılabilir?

Directions API ve Mesafe Matris API'si, Japonya'dakiler hariç tüm Google Transit iş ortaklarını destekler.

Maps JavaScript API'de hangi KML ve GeoRSS özellikleri desteklenmektedir?

Maps JavaScript API'deki Kmllayer sınıfı, geliştiricilerin KML/KMZ ve GeoRSS dosyalarını haritanın üzerine yerleştirmesine olanak tanır. Doküman ve örnekleri burada bulabilirsiniz.

Maps JavaScript API'nin Kmllayer sınıfı kullanılarak görüntülenebilecek KML'nin boyutu ve karmaşıklığıyla ilgili sınırlar nelerdir?

KmlLayer sınıfı kullanılarak KML'nin görüntülenmesiyle ilgili boyut ve karmaşıklık sınırları burada belirtilmiştir.

Bir haritadaki intranet sitelerinde barındırılan KML dosyalarını nasıl oluşturabilirim?

Maps JavaScript API'de KML yer paylaşımları oluşturan KmlLayer sınıfı, oluşturma işlemi için KML dosyalarını almak ve ayrıştırmak için Google tarafından barındırılan bir hizmet kullanır. Sonuç olarak, herkesin erişebileceği bir URL'de barındırılmayan veya erişim için kimlik doğrulama gerektiren KML dosyalarını görüntülemek mümkün değildir.

İntranet sitelerinde barındırılan KML dosyalarını kullanan uygulamalar geliştirmeniz gerekiyorsa, KML'yi üçüncü taraf JavaScript kitaplıklarını kullanarak istemci tarafında oluşturmanızı öneririz. KML dosyası tarayıcı tarafından analiz edildiğinden, performans, KmlLayer sınıfının kullanıldığı duruma kıyasla daha düşük olabilir.

Maps Static API tarafından desteklenen işaretçi veya yol köşelerinin maksimum sayısı nedir?

Maps Static API tarafından desteklenen işaretçi veya yol köşelerinin sayısında bir sınırlama yoktur. Özel simgeler kullanılırken istek başına en fazla beş benzersiz simge belirtilebilir ancak her biri harita içinde birden fazla kez kullanılabilir.

Maps Static API URL'lerinin en fazla 8.192 karakter içerebileceğini unutmayın. Bu sınır,her enlem/boylam çiftini belirtirken kullanılan ondalık basamak sayısına bağlı olarak belirtilebilecek işaretçi ve yol köşe noktalarının sayısını sınırlandırır. Kullanılan ondalık basamak sayısının yeryüzündeki doğrulukla ilişkisi hakkında bilgi edinmek için Ondalık Dereceler konulu Wikipedia makalesine bakın.

Belirli ülkeler için Google Haritalar Platformu ürünlerine neden erişemiyorum?

Maps API'ler, Yasaklanan Bölgeler'de kullanılamaz. Hizmet Şartları'na da göz atın.

Google temel haritasındaki bir sorunu nasıl bildirebilirim?

Aşağıdakiler gibi yanlış veya eksik harita bilgileri için Google Haritalar üzerinden geri bildirim gönderin:

Yanlış adresler veya işaretçi konumları
Yanlış yol adları
Tek yönlü ve çift yönlü yollar hakkında yanlış bilgiler
Yanlış çizilmiş yol
Kapalı yollar
Var olmayan yollar

Bir yerin veya işletme girişinin düzeltilmesi için düzenleme önerin.

Haritalar içeriğinin yasal nedenlerle kaldırılması gerekiyorsa yasal talep gönderin.

Kritik veya zaman açısından hassas istekler için nelerin düzeltilmesi gerektiğine dair belirli ayrıntıları içeren bir destek kaydı oluşturun.

Maps JavaScript API ile kullanılan hizmetler için performans nasıl izlenir?

Bazı istemci tarafı özellikleri, Hizmet Düzeyi Hedefi'nin hesaplanmasında başarı veya başarısızlığı raporlayacak şekilde donatılmıştır. Bu bilgiler, SLO bilgilerini günlüğe kaydeden çağrılarda maps.googleapis.com/maps_api_js_slo/log adresinden Google'a gönderilir. Bu bilgiler arasında başarı durumu, gecikme ve kullanımdaki Maps JavaScript API sürümü/kanalı yer alır. Çağrılar performans için toplu olarak işlenebilir. Bu çağrıların tarayıcı düzeyinde engellenmemesini sağlamak için İçerik Güvenliği Politikanızda maps.googleapis.com özelliğine izin vermeniz gerekebilir. Örneğin: HTTP üst bilgileri için Content-Security-Policy: default-src 'self' maps.googleapis.com; veya HTML Meta Etiketleri ile <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;">.

Maps JavaScript API

Maps JavaScript API yüklendikten sonra ne kadar süre çalışır?: Maps JavaScript API'yi yükleyen sayfayı en az 5 günde bir yenilemeniz gerekir.

iOS için Google Haritalar SDK'sı

kGMSPlacesRateLimitExceeded hatasını nasıl giderebilirim?

Bu hatayı görüyorsanız iOS için Yerler SDK'sının kullanımdan kaldırılmış bir sürümünü kullanıyor olabilirsiniz. iOS için Yerler SDK'sının 2.7.0 sürümü kapatılmıştır ve artık kullanılamamaktadır. Lütfen en kısa sürede uygulamanızı en son sürümü kullanacak şekilde güncelleyin. Ayrıntılar için taşıma rehberini inceleyin.

iOS 8.x bir cihazla hata ayıklarken kilitlenmeler alıyorum. What should I do?

iOS 8.x çalıştıran cihazlarda hata ayıklama yaparken sorun yaşıyorsanız çalıştırdığınız XCode şemasında GPU karesi yakalamayı devre dışı bırakmak için aşağıdaki adımları uygulayın:

XCode'da Product, Scheme, Manage Schemes'i (Şemaları Yönet) seçin.
Bir şema seçin ve Düzenle... seçeneğini belirleyin.
GPU Frame Capture (GPU Çerçeve Yakalama) seçeneğini Devre dışı olarak ayarlayın. Bu seçeneğin tüm cihazlarda mevcut olmayabileceğini unutmayın.

Genel iOS cihaz sayfasındaki Xcode GPU Çerçeve Yakalama seçeneği

Yuvarlak ve geniş ekranların Google Haritalar iOS SDK'sı üzerindeki etkisi nedir?

iPhone X'ten başlayarak iPhone'ların köşeleri yuvarlatılmış bir ekran şekli, cihazın sensör yuvasının üst kısmında bir çentik ve ekranın alt kısmında ana ekrana erişim için bir gösterge bulunur. iOS 11.0 SDK'sından itibaren Apple, geliştiricilerin öğeleri yeni ekran şekli tarafından kırpılamayacak bir alana yerleştirebilmesini sağlayan Safe Area API'yi eklemiştir.

Google Haritalar iOS SDK'sı, iç mekan seçici ve sorun bildir bağlantısı gibi birçok görsel öğe ve kontrol içerir. 2.4 sürümünde bu görsel öğeler ve denetimler, yeni ekran şekli sayesinde kırpılabilir. Yatay modda, iç mekan kat seçici, çentik veya ana sayfa düğmesi göstergesi tarafından kırpılabilir.

Google Haritalar iOS SDK 2.5'in yayınlanmasıyla birlikte bu düzen sorunları otomatik olarak düzeltilmektedir. Uygulamanız bir iPhone X veya sonraki bir cihazda kullanıldığında, görsel öğelerin kırpılmaması için GMSMapView ve GMSPanoramaView üzerindeki dolgu artırılır.

Varsayılan olarak dolgunuzu her zaman dahil ederiz. Google Haritalar iOS SDK'sı, dolgunun güvenli alan içinde doldurulacağını varsayar. Arayüzünüzü, her şeyin güvenli alanda yer aldığını varsayarak tasarlarsanız bu, ekstra çaba gerektirmeden işe yarar.

Varsayılan ayarlamamızla çalışmayan bir arayüz tasarladıysanız GMSmapView için dolguSettingBehavior adlı yeni bir özelliği kullanıma sunduk. GMSMapView artık üç dolgu düzenleme davranışından birini seçmenize olanak tanıyor: "Her Zaman" (varsayılan), "Otomatik" ve "Hiçbir Zaman".

GMSMapView, "Her Zaman" dolgu davranışını kullanacak şekilde ayarlanırsa dolguya her zaman güvenli alan eklemeleri ekler. Bu, tüm yerleşimlerin güvenli alanın kenarlarından olduğu varsayılarak arayüzünüzü tasarlamanıza olanak tanır. Bu, varsayılan değerdir.

GMSMapView, "Otomatik" dolgu davranışını kullanacak şekilde ayarlanırsa her zaman daha büyük olan dolgu veya güvenli alan eki seçer. Bu şekilde, hem ekran kenarından dolgu ekleyebilirsiniz hem de tüm öğelerin güvenli alanda kalmasını sağlayabilirsiniz.

GMSMapView, "Hiçbir zaman" dolgu davranışını kullanacak şekilde ayarlanırsa hiçbir zaman güvenli alan yerlerini dolguya eklemez. Bu, 2.5 sürümünden önceki davranıştır ve dolgunuz güvenli alanı zaten hesaba katıyorsa veya diğer davranışlarımız arayüzünüze uygun değilse yararlı olabilir. Google Haritalar Platformu Hizmet Şartları'nda belirtildiği gibi, Google logosunun ve telif hakkı bildirimlerinin her zaman görünür olmasını sağlamak sizin sorumluluğunuzdadır.

Buna karşılık GMSPanoramaView'da isteğe bağlı bir dolgu özelliği yoktur. Bu, düzenlenecek herhangi bir dolgu olmadığı ve GMSPanoramaView, tüm görsel öğelerin güvenli alanda yer almasını sağlamak için her zaman gerekli herhangi bir dolguyu uygulayacağı anlamına gelir.

Android için Google Haritalar SDK'sı

9005 PLACES_API_RATE_LIMIT_EXCEEDED hatasını nasıl giderebilirim?: Bu hatayı görüyorsanız Android için Yerler SDK'sının kullanımdan kaldırılmış bir sürümünü kullanıyor olabilirsiniz. Android için Yerler SDK'sının Google Play Hizmetleri sürümü kapatıldı ve artık kullanılamayacak. Lütfen en kısa sürede uygulamanızı en son sürümü kullanacak şekilde güncelleyin. Ayrıntılar için taşıma rehberini inceleyin.

Uygulamam, harita yerine yalnızca boş gri karolar gösteriyor. Bu sorunu nasıl çözebilirim?

Harita yerine boş gri karoların gösterilmesinin yaygın bir nedeni kimlik doğrulama sorunlarıdır. Bu sorunları gidermek için adb logcat'i kullanarak aşağıdaki adımları uygulayabilirsiniz.

Adb'nin yüklü olduğundan emin olun. Yoksa buradaki kılavuzu takip edebilirsiniz.
Sorunu gösteren uygulamayı bir cihaza veya Android emülatörüne yükleyin. Android emülatörü kullanıyorsanız emülatör ayarlarında Play Store'un bulunduğundan emin olun.
Android Studio terminalinde adb logcat -e "Google Maps Android API" komutunu çalıştırın. Bu komut yalnızca, günlük mesajının "Google Maps Android API" ile eşleştiği satırları yazdırır (İsteğe bağlı olarak, şunu ekleyerek günlüğün çıktısını bir metin dosyasına ekleyebilirsiniz: > logcat.txt)
Sorunu cihazınızda yeniden oluşturun ve aşağıdakiler gibi yaygın hataları kontrol edin:

Manifest'te yanlış/istenmeyen API anahtarına referans veriliyor.
Projede faturalandırma etkin değil.
SDK, proje API'lerinde etkin değildir.
API anahtarı kısıtlamalarına yanlış SHA1 parmak izi eklendi.
Google Play Hizmeti bağımlılıkları, build.gradle dosyasına dahil değildir.

URL imzalama

URL'leri JavaScript kullanarak imzalayabilir miyim?

URL imzalama gizli anahtarınızın son kullanıcılar tarafından görülmesine neden olacağından, URL'leri JavaScript kullanarak imzalamamanızı önemle tavsiye ederiz. Bu nedenle, imzalar yalnızca sunucu tarafı bileşenler tarafından oluşturulmalıdır.

Neden Maps API web hizmeti isteklerime HTTP 403 Yasak yanıtı alıyorum?

HTTP 403 yanıtı, izin sorununu belirtir. Bunun nedeni, bu isteğin imzasının doğrulanamaması olabilir. Bunun nedeni aşağıdakilerden biri olabilir:

Bir imza belirtildi ancak bu istek için yanlış.
İstek bir Google Haritalar Platformu Premium Planı'nı bir API anahtarı belirtiyor ancak bir imza belirtmiyor ve çağrılan hizmet, API anahtarı kullanılarak yapılan isteklerin geçerli bir imza içermesini gerektiriyor.
İmza belirtildi ancak ilişkili Google Haritalar Platformu Premium Plan API anahtarı belirtilmedi.