Google Haritalar Platformu Hakkında SSS

Başlayın

Hizmet şartlarını anlama

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

Google Haritalar Platformu'nu kullanma

Hatalar ve sorun giderme

Google Haritalar Platformu Hizmetleri

Maps JavaScript API

iOS için Google Haritalar SDK'sı

Android için Google Haritalar SDK'sı

URL imzalama

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 grubudur. Birkaç teklif vardır. İhtiyaçlarınıza bağlı olarak, aşağıdaki API'ler ve SDK'lardan birini veya birkaçını kullanıyor olabilirsiniz:

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.

Sitemde API'ları kullanmaya nasıl başlarım?

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

Google Haritalar Platformu hangi ülkeleri kapsıyor?

Google Haritalar ekibi, sürekli olarak yeni harita verileri aktarıyor ve uluslararası kapsamımızı genişletiyor. En son kapsam bilgileri için Google Haritalar kapsam verilerini inceleyin. Sayfanın üst kısmındaki filtre kutusuyla verileri filtreleyebilirsiniz. Veri sağlayıcılarla 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ünlerini kullanmadan Google Haritalar'ı siteme koyabilir miyim?

Evet. Google Haritalar artık görüntülemekte olduğunuz haritayı, herhangi bir programlama veya Google Haritalar Platformu kullanımı gerekmeden web sitenize veya blogunuza yerleştirme olanağı sunuyor. Buradan daha fazla bilgi edinebilirsiniz.

Google Haritalar uygulamalarını mobil cihazlarda nasıl dağıtabilirim?

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 cihazlara yönelik olarak 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 Static API, Haritalar JavaScript API'sinin kullanılmasına uygun olmayan cihazları hedefleyen uygulamalar için işaretçiler ve çoklu çizgiler dahil olmak üzere GIF, JPG ve PNG biçimlerinde harita görüntüleri yayınlar. Maps Static API'nin tarayıcı tabanlı uygulamaların dışında kullanılabilmesi için harita görüntüsünün 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, aşağıdaki 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 ana kararlı sürümü (Windows, macOS, Linux).
  • Chrome'un en son iki ana kararlı sürümü (Windows, macOS, Linux).
  • Safari'nin (macOS) en son iki ana 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 geçerli sürümü.
Maps JavaScript API'den harita yazdırabilir miyim?

Maps JavaScript API'den yazdırma desteklenmez. 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şiklikler olduğunda nasıl bilgilendirilebilirim?

Çeşitli Google Geo 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?

Mevcut 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 09:00-17:00 (Pasifik saati) ile hafta içi 24 saat hizmet vermektedir.
Google Hesabıma erişimi nasıl kurtarabilirim?

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

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:

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

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

Arm tabanlı yeni Mac'lerde geliştirme yapmak mümkündür 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 sağlamaya çalışırken bu geçici bir sınırlamadır.

Hizmet şartlarını anlama

Google Haritalar Platformu ürünlerinin 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 bulunmaktadır. Örneğin, bir şehirde yasa dışı uyuşturucu satın alınabilecek yerleri tanımlayan haritalar veya diğer yasa dışı faaliyetler. Kişilerin gizliliğine de saygı gösteririz. Bu nedenle, Google Haritalar Platformu bireylerle ilgili ö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 hukuk danışmanınızdan yardım almalısınız. Google mühendisleri yalnızca teknik yardım sunabilir ve hukuki yardımda bulunma konusunda kalifiye değildirler. 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 bloklarına veya uydu görüntülerine Google Haritalar Platformu dışındaki herhangi bir mekanizma (kendi harita API'nizin oluşturulması veya toplu karo indirme komut dosyasının kullanılması) üzerinden erişemezsiniz. Uygulamanızın kartlara Google Haritalar Platformu dışından erişmesi durumunda kartlara erişimi engellenir. Daha fazla bilgi için Google Haritalar Platformu Hizmet Şartları'na bakı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 herhangi bir kısıtlama yoktur.

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

Evet, Google Haritalar Platformu Hizmet Şartları'nın diğer kısıtlamalarına uymaları koşuluyla artık web harici 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.

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

Başvurunuz elektronik veya basılı biçimde bir belge oluşturuyorsa bu belgeye Google Haritalar Platformu'ndan (resimler dahil) hiçbir veri dahil edilemez. Daha fazla bilgi için lütfen Google Haritalar Platformu Hizmet Şartları 'nın "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 parametresi kullanımdan kaldırılmıştır ve herhangi 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 bir harita görüntüsü oluşturabilir miyim?

Web sitenizde Maps Static API kullanılarak oluşturulmuş 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. Böylece, tüm harita resimleri web sayfasının HTML içeriğinde görüntülenebilir ve Google tarafından son kullanıcılara doğrudan sunulabilir.

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 ücretli hesaba nasıl geçiş 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üresi sunar. Ücretsiz deneme süresi sona erdiğinde, bu hizmetleri kullanmaya devam etmek için ücretli bir hesaba yükseltme yapmanız gerekir. Ücretli hesaba yükseltmek için Cloud Console'u ziyaret edin.
Google Haritalar Platformu'nda kullanım sınırları var mı?

Google Haritalar Platformu ürünlerine gönderebileceğiniz istek sayısıyla ilgili herhangi bir maksimum günlük sınır yoktur ve yalnızca saniyedeki maksimum sorgu (QPS) veya dakika başına sorgu sayısı (QPM) ile ilişkilidir.

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

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

Aşağıdaki tabloda her bir API'nin kullanım sınırı gösterilmektedir.

API Kullanım sınırı
Adres Doğrulama Dakika Başına 6.000 Sorgu
Havadan Görünüm: Arama Videosu 180 QPM ve 100.000 QPD
Havadan Görünüm: Video Oluşturma PM 100 QPD ve 100 QPD
Hava Kalitesi Dakika Başına 6.000 Sorgu
Yol tarifi Dakika Başına 3.000 Sorgu
Mesafe Matrisi 60.000 EPM
Dinamik Haritalar 30.000 QPM
Rakım Dakika Başına 6.000 Sorgu
Coğrafi Kodlama Dakika Başına 3.000 Sorgu
Coğrafi konum Dakika Başına 6.000 Sorgu
Harita Kutuları API'sı: 2D Kartlar ve Street View Karoları PM 6.000 ve 15.000 QPD
Harita Karoları API'si: Fotogerçekçi 3D Karolar 300 QPD
Harita Karoları API'sı: Fotogerçekçi 3D Döşemeler: Oluşturucu Dakika Başına 12.000 Sorgu
Yerler Dakika Başına 6.000 Sorgu
Polen Dakika Başına 6.000 Sorgu
yollar PM 30.000
Rotalar: Compute Rotaları Dakika Başına 3.000 Sorgu
Rotalar: Compute Rota Matrisi 3.000 EPM
Güneş enerjisine bağlı Dakika Başına 600 Sorgu (QPM)
Statik Haritalar PM 30.000
Street View Image API PM 30.000
Saat Dilimi PM 30.000

Harcamaları yönetmek için API kullanımınızı izleyebilir ve faturalandırılabilir herhangi bir API'ye yapılan tüm isteklere 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 bölümüne bakı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 görüntüsü ister.

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

  • Statik (etkileşimsiz) bir Street View panoramasına yerleştirme amacıyla Street View Static API'ye yapılan her istek için statik bir Street View panoraması için ücret alınır.
  • Dinamik bir Street View panoraması; Maps JavaScript API, Android için Haritalar SDK'sı veya iOS uygulaması için Haritalar SDK'sında bulunan 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, herhangi bir kullanıcı etkileşimi (kaydırma, yakınlaştırma veya harita katmanlarını değiştirme gibi) 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 ücretler oluşturabilir (ör. "google.maps.Map()" sınıfının yüklenmesi veya yeniden yüklenmesi).

Kullanımımı nasıl izleyebilirim?

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

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

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

  1. Henüz yapmadıysanız faturalandırma ayarlarını yapın.
  2. Cloud Console faturalandırma sayfasına gidin.
  3. Proje seçin.
  4. 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ızı 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şarsanız API'ye erişiminiz geçici olarak engellenebilir.

İstek QPS sınırlarını aşarsanız 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 Matrisi, Yükseklik ve Coğrafi kodlama.

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 bırakır ve tekrar daha fazla kullanıma izin verilene kadar yalnızca OVER_QUERY_LIMIT durum kodunu döndürmeye geçer. Hata, uygulamanız saniyede çok fazla istek gönderdiği için alındıysa bu durum birkaç saniye içinde gerçekleşebilir.

QPS kullanım sınırlarınızı düzenli olarak aşıyorsanız uygulamaları Google Haritalar Platformu ürünlerini daha verimli kullanacak şekilde optimize ederek kullanımı azaltmayı düşünebilirsiniz. Daha fazla bilgi için Optimizasyon Kılavuzu'na bakın.

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

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

Bir faturalandırma hesabınız olduğunda, ücretsiz, aylık 200 ABD doları tutarındaki 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.) API artık siz geçerli bir ödeme yöntemi ekleyene kadar çalışmaz.

Kullanım nasıl hesaplanacak ve faturalandırılır?

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 bir bakış için Fiyatlandırma Tablosu'na bakın. Uygulamanız aylık 200 ABD dolarına kadar istekler veya harita yükü hacimleri oluşturursa kullanımınız için ücret alınmaz. Aylık 200 ABD doları krediyi 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.

Fiyatlandırma diğer para birimlerinde geçerli mi?

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

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

Google, belirttiğiniz ödeme yöntemini kullanarak her ayın başında 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:

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 maksimum günlük kullanımla ilgili bir üst sınır belirleyebilirsiniz. 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ışlardan kaçınmak amacıyla günlük kullanım üst sınırı ayarlayabilirsiniz. Aşağıdaki adımları uygulayarak Cloud Console'da bu sınırı değiştirebilirsiniz:

  1. API'ler ve Hizmetler Kontrol Paneli'ne gidin.
  2. İstenirse bir proje seçin.
  3. Listeden bir API seçin, ardından Kotalar sekmesini tıklayın.
  4. "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ı belirleme 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ı ayarlayın. Faturalandırma hesabındaki tahmini ücretler eşiğin %50, %90 ve% 100'ünü aştığında faturalandırma yöneticilerine e-posta bildirimleri gönderilir.

Projemin "Google Haritalar Platformu Geçiş Hesabı" ile bağlantı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 kredi vermesini sağladı. Böylece müşteriler, Google Haritalar Platformu'nu 200 ABD doları değerindeki ücretsiz katmanla sınırlı olarak kullanmaya devam edebilir. Bu sınır aşıldığında faturalandırma hesabı kapatılır ve hizmete erişimi kaybedersiniz. Hizmet kesintilerini önlemek için kendi faturalandırma hesabınızı ayarlamanızı ve 200 ABD doları değerindeki aylık ücretsiz katman kredisini kullanmaya devam etmenizi öneririz. Projenize ait faturalandırma hesabını değiştirmek için:

  1. Yeni bir faturalandırma hesabı oluşturun (Zaten faturalandırma hesabınız varsa bu adımı atlayabilirsiniz).
  2. Faturalandırma hesabını projenizle ilişkilendirin.
Kota sınırım neden günde 1 istek olarak ayarlı? Bu sınırı nasıl yükseltebilirim?

Bir faturalandırma hesabı oluşturup projenize eklemediyseniz Maps Platform API'leriniz günlük 1 istekle sınırlandırılır. 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.

Bir 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 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ımlandığı şekilde Google'ın şartlarını ihlal etmektedir. 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 bölümüne 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'ın size sağladığı 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ı bölümüne bakın.
  • API anahtarına bir uygulama kısıtlaması ekleyebilirsiniz. Kısıtlanan anahtarlar, yalnızca bu 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ü zorunlu kılan API'ler, aynı kısıtlanmış anahtarı kullanabilir.
  • API anahtarına bir API kısıtlaması da ekleyebilirsiniz. Daha fazla bilgi için API anahtarı alma, ekleme ve kısıtlama bölümünü inceleyin.

Aşağıdaki tabloda, her bir Google Haritalar Platformu API'si/SDK 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ı1
Android için Yerler SDK'sı Android kısıtlaması olan API anahtarı1
iOS için Haritalar SDK'sı iOS kısıtlamasına sahip API anahtarı1
iOS için Yerler SDK'sı iOS kısıtlamasına sahip API anahtarı1
Maps JavaScript API HTTP yönlendiren kısıtlamalı API anahtarı1
Map Tiles API IP adresi kısıtlamalı API anahtarı1
Aerial View API IP adresi kısıtlamalı API anahtarı1
Maps Static API HTTP yönlendiren kısıtlamalı API anahtarı1 + Digital Signature2
Street View Static API HTTP yönlendiren kısıtlamalı API anahtarı1 + Digital Signature2
Maps Embed API HTTP yönlendiren kısıtlamalı API anahtarı1
Address Validation API (Adres Doğrulama API'si) IP adresi kısıtlamalı API anahtarı1
Directions API IP adresi kısıtlamalı API anahtarı1
Mesafe Matrisi API'si IP adresi kısıtlamalı API anahtarı1
Elevation API IP adresi kısıtlamalı API anahtarı1
Geocoding API IP adresi kısıtlamalı API anahtarı1
Geolocation API IP adresi kısıtlamalı API anahtarı1
Places API IP adresi kısıtlamalı API anahtarı1
Roads API IP adresi kısıtlamalı API anahtarı1
Routes API IP adresi kısıtlamalı API anahtarı1
Time Zone API IP adresi kısıtlamalı API anahtarı1
Air Quality API IP adresi kısıtlamalı API anahtarı1
Pollen API IP adresi kısıtlamalı API anahtarı1
Solar API IP adresi kısıtlamalı API anahtarı1
1 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.
2 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ü 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ıyla başarısız olur: "API anahtarları, bu API ile 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önlendirenden 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ıtlama uygulamanız gerekiyorsa gerekli kısıtlamayla ayrı bir anahtar ekleyin. Yeni 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.

Bir API anahtarını IP adresi kısıtlamasına HTTP başvuran kısıtlamasıyla değiştirmek için aşağıdakileri yapın:

  1. Cloud Console'un Kimlik bilgileri sayfasına gidin.
  2. Düzenlemek istediğiniz API anahtarını içeren projeyi seçin.
  3. Kimlik bilgileri sayfasında, API anahtarları listesinden API anahtarının adını seçerek anahtarın ayrıntılarını düzenleyin.
  4. Sayfanın Anahtar kısıtlaması bölümünde "IP adresleri (web sunucuları, cron işleri vb.)" seçeneğini belirleyip uygun sunucu IP adreslerini girin ve Kaydet'i tıklayın.
Nasıl yeni bir API anahtarı alabilirim?
Google Haritalar Platformu'nu Kullanmaya Başlama başlıklı makaleyi inceleyin.
Google Haritalar API'lerinin her bir sürümünde yapılan değişiklikleri nasıl bulabilirim?

Google Haritalar API'larının birçoğu için 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'yi bir sayfaya eşzamansız olarak nasıl yükleyebilirim?

API'yi yüklerken geri çağırma parametresini belirtmeniz yeterlidir. Daha fazla bilgiyi ve örnek kodu, Maps JavaScript API dokümanlarının Başlarken bölümünde 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ğı hakkında daha fazla bilgiyi her API'nin dokümanlarında bulabilirsiniz:

Desteklenen Diller:

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

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şileceği hakkında bilgi edinmek için lütfen ilgili API'nin belgelerine bakın.

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

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 ilk olarak bunu ilgili forumda bildirin. Bu, diğer geliştiricilerin hatayı doğrulamasına ve kodunuzla ilgili olası sorunları ortadan kaldırmasına olanak tanır.

Bir özellik isteğinde bulunmak istiyorsanız lütfen öncelikle bu isteğinizi ilgili forumda dile getirerek gereksinimlerinizi karşılayan bir çözümün mevcut olmadığını onaylayın.

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 Issue Tracker'ı kullanarak hatanızı ya da özellik isteğinizi bildirin.

Sorun İzleyici'ye hata veya özellik isteği eklemeden önce lütfen ilgili hatanın veya özelliğin zaten eklenmediğinden emin olun. Sorun çözüldüyse 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ır?

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 çerezler 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ğiyle düzenlenen bir soru-cevap sitesi olan Stack Overflow'da yer almaya devam etmektedir. Burası, Google Haritalar uygulamalarının geliştirilmesi ve bakımı hakkında teknik sorular sormak için ideal bir platformdur. 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:

  • Geçerli tartışmalarda arama yapın. Başka biri benzer bir sorun yaşamış ve bir çözüm bulmuş olabilir.
  • 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 yararlı 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 bir 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, karartılmış bir harita veya "yalnızca geliştirme amaçlı" metnini 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 bir 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ı olacaktır:


OVER_DAILY_LIMIT veya OVER_QUERY_LIMIT hata kodlarını nasıl çözebilirim?
Bu hata kodları, aşağıdaki nedenlerden herhangi biri dolayısıyla döndürülebilir:
  • İstekte bir API anahtarı eksik.
  • Sağlanan API anahtarı geçersiz.
  • Projeye eklenmiş bir faturalandırma hesabı yok.
  • Kullanıcı tarafından belirlenen kullanım sınırı aşıldı.
  • Sağlanan ödeme yöntemi artık geçerli değil (ör. kredi kartının geçerlilik süresi sona ermiş).
  • 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. Bu sorunu gidermek için aşağıdaki adımları uygulayın:

kGMSPlacesRateLimitExceeded veya 9005 PLACES_API_RATE_LIMIT_EXCEEDED hata kodlarını nasıl çözebilirim?
kGMSPlacesRateLimitExceeded veya 9005 PLACES_API_RATE_LIMIT_EXCEEDED simgesini 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. Daha fazla bilgi edinmek ve yeni SDK'ları bulmak için https://goo.gle/places-sdk-deprecation adresine gidin.
"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, 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ı 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öndermeye çalışıyor.
  • Önceden web hizmeti API'lerinden herhangi birini, HTTP yönlendirici kısıtlamaları olan bir API anahtarıyla kullandıysanız bu hatayı almak mümkündür. 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 değiştirin. API anahtarlarını kısıtlama hakkında daha fazla bilgi için API Anahtarı En İyi Uygulamaları'na 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:

  1. Cloud Console'un Kimlik bilgileri sayfasına gidin.
  2. İncelemek istediğiniz API anahtarını içeren projeyi seçin.
  3. Anahtar için ayarlanan kısıtlamalar 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.
  4. Anahtar için ayarlanan kısıtlamalar dahil olmak üzere seçilen API anahtarının tam kimlik bilgileri gösterilir. Buradan, kısıtlamalar gerektiği şekilde değiştirilebilir, silinebilir veya güncellenebilir.
"Yönlendiren kısıtlamalarına sahip API anahtarları bu API ile kullanılamaz" hatasını nasıl giderebilirim?

HTTP yönlendireniyle sınırlı 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ı 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. Bunu Google Haritalar Platformu ile yapabilir miyim?

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

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

Coğrafi kodlama hangi ülkelerde kullanılabiliyor?

Google Haritalar Platformu coğrafi kodlayıcıları tarafından şu anda 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şiklik gösterebilir. 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 önerilir. Coğrafi kodlama verilerinin kullanılabilirliğinin, veri sağlayıcılarla yaptığımız sözleşmelere bağlı olduğunu, bu nedenle verilerin 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, sonuçların zaman içinde değiştiğini veya iyileştiğini görebilirsiniz.

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

Coğrafi kodlayıcı, açık adresleri coğrafi koordinatlarla eşleştirmek için tasarlanmıştır. Bu nedenle, sorgunun başarılı olma 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 servisi tarafından kullanılan biçime uygun olarak belirtin.
  • İlgili ülkenin posta hizmeti tarafından tanımlanan adrese dahil edilmemiş işletme adı, birim numaraları, kat numaraları veya daire numaraları gibi ek adres öğeleri belirtmeyin. Bu, ZERO_RESULTS ile yanıt verilmesiyle sonuçlanabilir.
  • Artı kodlarını burada gösterildiği gibi biçimlendirin (artı işaretleri %2B için URL çıkışlı, boşluklar da %20 için URL çıkışlıdır):
    • global kod, 4 karakterden oluşan bir alan kodu, 6 veya daha uzun bir yerel koddur (849VCWC8+R9, 849VCWC8%2BR9'dir).
    • bileş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 binanın sokak numarasını kullanın.
  • Mümkün olduğunda ara sokakları belirtmek için sokak numarası adresi 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 adreslerde belirtilmesini zorunlu kılar:

  • İ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. "California 82"
  • ABD Otoyolları: "U.S. NNN" NNN, otoyol numarasıdır. ör. "U.S. 101"
  • ABD eyaletler arası: "Interstate NNN"; burada NNN, eyaletler arası numaradır. Ör. "Interstate 280"
API coğrafi kodlayıcı sınıfını 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 sağlayabilirim?

Routes API ve Directions API'nin Compute Routes hizmeti ile tek ve çok ayaklı yolculuklar için arabayla yol tarifleri sunabilirsiniz. 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ı sizin için otomatik olarak yer paylaşımlarını ve yol tarifleri panelini oluşturabilir. Dokümanlarda ek örnekler sağlanmıştır.
  • Sunucu tarafı uygulamalar için Java, Python, go ve Node.js istemci arayüzleri aynı işlevi sunar. İ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 verilerini inceleyin. 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ılabiliyor?

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 desteklenir?

Maps JavaScript API'nin KmlLayer sınıfı, geliştiricilerin KML/KMZ ve GeoRSS dosyalarını haritanın üzerine yerleştirmesine olanak tanır. Belgelere ve örneklere buradan ulaşabilirsiniz.

Maps JavaScript API'nin Kmltier sınıfını kullanarak 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 açıklanmıştır.

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 amacıyla KML dosyalarını almak ve ayrıştırmak için Google tarafından barındırılan bir hizmet kullanır. Dolayısıyla, herkesin erişebileceği bir URL'de barındırılmayan veya erişim için kimlik doğrulama gerektiren KML dosyalarının görüntülenmesi 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ı kullanımına kıyasla daha düşük olabilir.

Maps Static API'nin desteklediği maksimum işaretçi veya yol köşe noktası sayısı nedir?

Maps Static API'nin desteklediği işaretçi veya yol köşelerinin sayısında bir sınırlama yoktur. Özel simgeler kullanı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 yaklaşık 8.192 karakter içerebileceğini unutmayın. Bu sınır, her bir 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 dünyanın doğruluğuyla nasıl bir ilişkisi olduğu hakkında bilgi için Ondalık Dereceler başlıklı Wikipedia makalesine bakın.

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

Haritalar API'leri, Yasaklanan Bölgeler'de kullanılamaz. Hizmet Şartları'nı da inceleyin.

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ği konusunda ayrıntılı bilgi vererek bir destek kaydı oluşturun.

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

Bazı istemci taraflı özellikler, Hizmet Düzeyinin Hedefi (Hizmet Düzeyi Hedefi) hesaplamasına yönelik olarak başarı veya başarısızlığı raporlayacak şekilde ayarlanır. Bu bilgiler, STO bilgilerini günlüğe kaydeden çağrılarda maps.googleapis.com/maps_api_js_slo/log adresinde Google'a gönderilir. Bu bilgiler arasında, kullanılan Maps JavaScript API'nin başarı durumu, gecikme süresi ve sürümü/kanalı bulunur. Çağrılar, performans için toplu olarak işlenebilir. Bu çağrıların tarayıcı düzeyinde engellenmediğinden emin olmak için İçerik Güvenliği Politikanızda maps.googleapis.com öğesine 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 kez 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ü devre dışı bırakılmış olup 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 kılavuzuna bakın.
iOS 8.x yüklü bir cihazda hata ayıklarken kilitlenmelerle karşılaşı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 kare yakalamayı devre dışı bırakmak için şu adımları uygulayın:

  1. XCode'da Product, Scheme, Manage Schemes'i (Şemaları Yönet) seçin.
  2. Bir şema seçin ve Düzenle... seçeneğini belirleyin.
  3. GPU Frame Capture (GPU Çerçeve Yakalama) seçeneğini Disabled (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
Google Haritalar iOS SDK'sı üzerindeki yuvarlak ve geniş ekranların etkisi nedir?

iPhone X tarihinden itibaren iPhone'ların köşeleri yuvarlatılmış bir ekran şekli, cihazın sensör yuvasının üst kısmında bir çentik ve ana ekrana erişmek için ekranın alt kısmında bir gösterge bulunur. iOS 11.0 SDK'sından itibaren Apple, geliştiricilerin öğeleri yeni ekran şekli tarafından kırpılmaya karşı güvenli bir alanda konumlandırmasını sağlayan Safe Area API'yi de eklemiştir.

Google Haritalar iOS SDK'sında iç mekan seçici ve sorun bildirme bağlantısı gibi birçok görsel öğe ve kontrol bulunur. Sürüm 2.4 ile bu görsel öğeler ve kontroller, yeni ekran şekli tarafından 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 sürümüyle birlikte bu düzen sorunları otomatik olarak düzeltilir. Uygulamanız iPhone X veya sonraki bir cihazda kullanıldığında, görsel öğelerin kırpılmaması için GMSMapView ve GMSPanoramaView'daki dolgu artırılır.

Varsayılan olarak dolgunuzu her zaman dahil ederiz. Google Haritalar iOS SDK'sı, dolgunun güvenli alan içinde doldurulmasının amaçlandığını varsayar. Arayüzünüzü, her şeyin güvenli alanda yer aldığını varsayarak tasarlarsanız, bu yaklaşım fazladan çaba gerektirmeden çalışacaktır.

Varsayılan ayarımızla çalışmayan bir arayüz tasarladıysanız GMSMapView'a paddingAdjustBehavior adlı yeni bir özelliği kullanıma sunduk. GMSMapView artık üç dolgu ayarlama davranışından biri arasından seçim yapmanıza 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 girişlerini ekler. Bu, tüm yerleşimin güvenli alanın kenarlarından olduğu varsayımıyla 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 dolgu veya güvenli alan eki seçilir. Bu, hem ekran kenarından dolgu eklemenize hem de tüm öğelerin güvenli alanda kalmasını sağlamanıza olanak tanır.

GMSMapView, "Hiçbir zaman" dolgu davranışını kullanacak şekilde ayarlanırsa dolguya hiçbir zaman güvenli alan eklemelerini eklemez. Bu, 2.5 sürümünden önceki davranıştır ve dolgunuz güvenli alanı zaten dikkate alı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, ayarlanacak dolgu olmadığı anlamına gelir ve GMSPanoramaView, tüm görsel öğelerin güvenli alanda olmasını sağlamak için her zaman gerekli dolguyu uygular.

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ılamıyor. 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 kılavuzuna bakın.
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ı izleyebilirsiniz.

  1. Adb'nin yüklü olduğundan emin olun. Aksi halde buradaki kılavuzu inceleyebilirsiniz.
  2. Sorunu gösteren uygulamayı bir cihaza veya Android emülatöre yükleyin. Android emülatör kullanıyorsanız emülatör ayarlarında Play Store'un bulunduğundan emin olun.
  3. Android Studio terminalinde adb logcat -e "Google Maps Android API" komutunu çalıştırın. Bu işlem 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ük çıktısını bir metin dosyasına ekleyebilirsiniz: > logcat.txt)
  4. 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ğil.
    • API anahtarı kısıtlamalarına yanlış SHA1 parmak izi eklendi.
    • Google Play Hizmeti bağımlılıkları build.gradle dosyasına dahil edilmez.

URL imzalama

URL'leri JavaScript kullanarak imzalayabilir miyim?

URL imzalama gizli anahtarınızın son kullanıcılara gösterilmesine 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ı, izinle ilgili bir sorunu belirtir. Bunun nedeni, imzanın bu istek için doğrulanamaması olabilir. Bunun nedeni aşağıdakilerden biri olabilir:

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