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ştirmesine veya Google Haritalar'dan veri almasına olanak tanıyan bir API ve SDK grubudur. Birkaç fırsat vardır. İhtiyaçlarınıza bağlı olarak aşağıdaki API'lerden ve SDK'lardan birini veya bunların bir kombinasyonunu kullanabilirsiniz:

Haritalar:

Rotalar:

Yerler:

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

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

Hangi API'ye ihtiyacım var?

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

Sitemde API'leri kullanmaya nasıl başlayabilirim?

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

Google Haritalar Platformu hangi ülkeleri kapsıyor?

Google Haritalar ekibi sürekli olarak yeni harita verilerini dışarı çıkarıp uluslararası kapsamımızı genişletmektedir. En son kapsam bilgileri için Google Haritalar kapsam verilerine bakın. Sayfanın üst kısmındaki filtre kutusuyla verileri filtreleyebilirsiniz. Veri sağlayıcılarla yapılan lisans sözleşmelerinin değişmesi halinde kapsam verilerinin değişebileceğini lütfen unutmayın.

Şu kaynakları da inceleyin:

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

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

Evet. Google Haritalar artık görüntülediğiniz haritayı web sitenize veya blogunuza, Google Haritalar Platformu'nu programlama veya kullanmaya gerek kalmadan yerleştirme olanağı sunuyor. Daha fazla bilgiye buradan ulaşabilirsiniz.

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

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

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

Haritalar JavaScript API'si, mobil cihazlara yönelik olarak geliştirilmiştir ve hem masaüstünü hem de Apple iPhone gibi tam JavaScript uygulaması olan bir web tarayıcısı içeren cihazları hedefleyen tarayıcı uygulamaları için uygundur.

Maps Static API, Maps JavaScript API'yi kullanmaya 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 sağlar. Maps Static API'yi tarayıcı tabanlı uygulamaların dışında kullanmak için harita resminin Google Haritalar'a bağlı olması gerekir.

Maps JavaScript API ve Maps Yerleştirme API'si hangi web tarayıcılarını destekler?

Maps JavaScript API ve Maps Yerleştirme API'si aşağıdaki web tarayıcılarını destekler:

Masaüstü

IE modunun hariç olduğu Microsoft Edge'in (Windows) geçerli sürümü.
Firefox'un son iki kararlı ana sürümü (Windows, macOS, Linux).
Chrome'un en son iki kararlı kararlı sürümü (Windows, macOS, Linux).
Safari'nin (macOS) en son iki kararlı sürümü.

Android

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

iOS

iOS'un mevcut ve önceki ana sürümlerinde Mobil Safari.
iOSWeb'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 desteklenmiyor. 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 yapılan değişiklikler hakkında nasıl bildirim alabilirim?

Çeşitli Google coğrafi geliştirici teklifleri hakkında haberler için Google Haritalar Platformu Blogu'na abone olmanız gerekir.

Teknik destek ekibiyle nasıl iletişime geçebilirim?

Mevcut destek seçenekleri hakkında bilgi edinmek için Google Haritalar Platformu Desteği ve Kaynakları'na göz atın.

Teknik destek ne zaman sunuluyor?

Destek ekibi "hizmet kullanılamıyor" sorunları nedeniyle bölgesel tatiller hariç olmak üzere, 09:00 Tokyo saatinden 05:00 Pasifik saatine göre hafta içi 7/24 hizmet vermektedir.

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

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

Not: G Suite hesabına erişimi geri yüklemek 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 kurtarmayı deneyebilirsiniz.

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

Proje Sahibi'ni tanıyorsanız ve Google Hesabınıza erişiminiz varsa: 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çip sizi Proje Sahibi olarak eklemesini isteyin.
Mevcut Proje Sahiplerinden hiçbirini bilmiyorsanız Proje Sahibinin kim olduğunu bilmiyorsanız veya Proje Sahibi kullanılamıyorsa projeyi kurtarmaya yönelik ek seçenekleri keşfetmek için destek ekibiyle iletişime geçin.

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

Google Hesabınıza erişiminizi kaybettiyseniz: 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çip yeni Google Hesabınızı projeye eklemesini isteyin.

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

Bununla birlikte, yeni Arm tabanlı Mac'lerde geliştirme yapmak mümkündür. Ancak fiziksel bir iOS cihazında derleme ve çalıştırma gerekir. Bu durum, simülasyon araçlarında uygulama geliştirme için daha fazla destek sağlamaya çalışırken geçici bir sınırlamadır.

Hizmet şartlarını anlama

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

Google Haritalar Platformu Hizmet Şartları'nın bulunduğu yerler:

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

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

Siteniz Google Haritalar Platformu Hizmet Şartları'nı karşıladığı sürece Google Haritalar Platformu'nu uygulamalarınızda kullanabilirsiniz.

Ancak, Google Haritalar Platformu'nun görmek istemediğimiz bazı kullanım alanları vardır: Örneğin, bir şehirde yasa dışı uyuşturucu satın alabileceğiniz yerleri veya diğer yasa dışı etkinlikleri tanımlayan haritalar. Ayrıca kullanıcıların gizliliğine de saygı gösteririz. Bu nedenle, Google Haritalar Platformu şahıslarla ilgili gizli bilgileri tanımlamak için kullanılmamalıdır.

Uygulamanızı geliştirip lanse etmeden önce uygulamanızın Google Haritalar Platformu Hizmet Şartları'na uygun olup olmadığını belirlemek için kendi hukuk danışmanınızı kullanmalısınız. Google mühendisleri yalnızca teknik destek sunabilir ve hukuki danışmanlık hizmeti vermeye uygun değildir. Google, hizmet kullanımınızı istediği zaman askıya alma veya feshetme hakkını saklı tutar. Bu nedenle, Haritalar API'leri Şartları'nı dikkatli bir şekilde okuyun.

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

Harita parçalarına veya uydu görüntülerine Google Haritalar Platformu dışında herhangi bir mekanizmaya (kendi eşleme API'nizin oluşturulması veya toplu karo indirme komut dosyasının kullanılması gibi) erişemezsiniz. Google Haritalar Platformu dışında kartlara erişen uygulamanızın kutulara erişimi engellenir. Daha fazla bilgi için Google Haritalar Platformu Hizmet Şartları'na bakın.

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

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

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

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

Maps JavaScript API yalnızca desteklenen tarayıcılardan birinde çalışırken desteklenir.

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

Evet, Google Haritalar, Rotalar, Yerler hizmetleri özel erişimli uygulamalarla kullanılabilir. Daha fazla bilgi için Google Haritalar Platformu Hizmet Şartları'na göz atın.

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

Uygulamanız, elektronik veya basılı biçimde bir doküman oluşturursa resimler de dahil olmak üzere Google Haritalar Platformu'ndan veri alınamaz. Daha fazla bilgi için lütfen Google Haritalar Platformu Hizmet Şartları "Toplama Yok" bölümüne bakın.

İçeriğimi Google arama sonuçlarına dahil etmeyi nasıl devre dışı bırakabilirim?

Bu verileri artık toplamıyoruz. indexing parametresinin kullanımı kullanımdan kaldırıldı ve herhangi bir etkisi yoktur. Açıkça devre dışı bırakmanız gerekmez ancak bu parametreyi en kısa sürede kaldırmanızı öneririz.

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

Web sitemde depolayıp sunduğum Maps Static API'yi kullanarak harita resmi oluşturabilir miyim?

Maps Static API kullanılarak oluşturulan resimlerin kopyalarını web sitenizde depolayamaz ve sunamazsınız. Statik resimler gerektiren tüm web sayfalarının, tüm HTML resimlerinin web sayfasının HTML içeriğinde görüntülenmesi ve doğrudan Google tarafından son kullanıcılara sunulması için bir HTML img etiketinin src özelliğini veya bir HTML div etiketinin CSS background-image özelliğini doğrudan Maps Static API'ye bağlaması gerekir.

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

Projem için faturalandırma ayarlarını nasıl yaparım?

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

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

Google Cloud Platform Ücretsiz Katman programı, müşterilere Google Haritalar Platformu (GMP) API'leri dahil olmak üzere tüm Google Cloud Platform (GCP) hizmetlerinde kullanabilecekleri 300 ABD doları değerinde ücretsiz kredi sunar. Ücretsiz deneme süresi sona erdiğinde bu hizmetleri kullanmaya devam etmek için ücretli bir hesaba geçmeniz gerekir. Ücretli bir 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 yönelik maksimum günlük istek sayısı sınırı yoktur ve yalnızca kullanım sınırları, saniye başına maksimum sorgu sayısı (QPS) veya dakika başına sorgu sayısı (QPM) ile ilgilidir.

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

Rotalar:Compute Rota Matrisi için sınır, dakika başına öğe sayısı (EPM) şeklindedir ve bir istekteki öğe sayısı şuna eşittir: (kaynak sayısı × hedef sayısı).

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

API	Kullanım sınırı
Adres Doğrulama	6.000 QPM
Yol tarifi	50 QPS
Mesafe Matrisi	1.000 EPS
Dinamik Haritalar	500 QPS
Rakım	100 QPS
Coğrafi Kodlama	50 QPS
Coğrafi Konum	100 QPS
Yerler	100 QPS
Yollar	500 QPS
Rotalar: Hesaplama Rotaları	3.000 QPM
Rotalar: Compute Rota Matrisi	3.000 EPM
Statik Haritalar	500 QPS
Street View Image API	500 QPS
Saat Dilimi	500 QPS

Harcamaları yönetmek için API kullanımınızı izleyebilir ve faturalandırılabilir herhangi bir API'ye 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 şekilde dağıtılmalıdır.

Kullanım maliyeti nasıl hesaplanır?

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

Google Haritalar Platformu API'lerinin nasıl faturalandırıldığı hakkında daha fazla bilgi edinmek için lütfen Haritalar, Rotalar ve Yerler için faturalandırmayı anlama bölümüne bakın.

Harita yüklemeleri Google Haritalar Platformu'nda nasıl sayılır?

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

Bir web sayfası veya uygulama, Maps JavaScript API'yi kullanarak bir harita görüntüler.
Bir uygulama, Maps Static API'den tek bir harita görüntüsü istiyor.

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ı ücreti alınır.
Dinamik bir Street View panoraması; Maps JavaScript API, Android için Haritalar SDK'sı veya iOS için Haritalar SDK'sındaki her panoramik nesne örneği için ücretlendirilir.

Bir web sayfası veya uygulama bir harita, statik bir harita resmi ya da Street View panoraması yükledikten sonra, bu görüntü ile etkileşimde bulunan herhangi bir kullanıcı (ör. kaydırma, yakınlaştırma veya harita katmanı değiştirme) ek harita yüklemeleri oluşturmaz veya kullanım sınırlarını etkilemez.

İşaretçi eklemek ek harita yüklemeleri oluşturmaz, ancak sabit konumun nasıl belirlendiğine (`google.maps.Map()` sınıfının yüklenmesi veya yeniden yüklenmesi gibi) ilişkin ücretlere neden olabilir.

Kullanımımı nasıl izlerim?

Google Cloud Console'da bağımsız API'lerin kullanımını izleyebilirsiniz.

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

Tüm projenin trafik raporunu ve fatura bilgilerini görmek için ş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ızdaki raporları görüntülemek için sağ kenar çubuğundaki filtreleri kullanın.

Daha fazla bilgi edinmek için Google Haritalar Platformu Raporları ve API Kullanımını İzleme, API Kullanımını Sınırlama makalelerine göz atabilirsiniz.

İ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ı verir. Sınırları tekrar tekrar aşmanız halinde API'ya 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: Web hizmeti API'lerinden dördü Maps Maps API'de bulunan eşdeğer bir istemci taraflı hizmete sahiptir: 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 OVER_QUERY_LIMIT durum kodu alacaksınız.

Bu, web hizmetinin normal yanıtlar vermeyi durduracağı ve tekrar kullanıma izin verilene kadar yalnızca OVER_QUERY_LIMIT durum kodunu döndürmeye geçeceği anlamına gelir. Uygulamanız saniyede çok fazla istek gönderdiğinden hata 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ılavuzuna bakın.

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

Evet. Bununla birlikte, uygulamanızın bağımlı olduğu Google Haritalar Platformu için kullanım sınırlarını öğrenmenizi öneririz.

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

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

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

Kullanım her günün sonunda hesaplanır ve Fiyatlandırma Sayfasında gösterildiği gibi fiyatlandırılır. Her ayın sonunda toplam kullanım için faturalandırma hesabınızla ilişkilendirilmiş ödeme yöntemi kullanılı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 Sayfası'na göz atın. Uygulamanız, istekler veya aylık kullanım miktarı 200 ABD dolarına varan harita yükü hacimleri oluşturuyorsa kullanımınız ücretlendirilmez. Aylık 200 ABD doları kredisini aşan kullanımlar faturalandırma hesabınızdan tahsil edilir. Daha fazla bilgi için Google Haritalar Platformu faturalandırmasını anlama kılavuzumuzu inceleyin.

Fiyatlandırma diğer para birimlerinde de mevcut mu?

Konsolda başka para birimleri de bulunabilir. Farklı bir para birimi seçtiğinizde, fiyatlar Fiyatlandırma Sayfamızda listelenen ABD doları eşdeğerinden dönüştürülür.

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

Google, bir önceki ayın etkinliği için sizden her ay başında, belirlediğiniz ödeme yöntemini kullanarak ücret 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 makbuzu alma hakkında bilgi edinin.
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 günlük maksimum faturalandırılabilir sınırlar belirleme yolları sunar. Beklenmedik artışlara karşı koruma sağlamak için maksimum günlük kullanım sınırını sınırlayabilirsiniz. Faturalandırma hesabında yapılan ödemeler, belirlediğiniz eşiğe ulaştığında e-posta bildirimleri almak için bütçe uyarıları da ayarlayabilirsiniz.

Maksimum günlük faturalandırılabilir limiti sınırlama:

Büyük bir faturadan kaçınmak için kullanımdaki beklenmedik artışlardan kaçınmak amacıyla günlük kullanım sınırı ayarlayabilirsiniz. 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, ardından Kotalar sekmesini tıklayın.
"İstek 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 kota düzenleyebilirsiniz.

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

Faturalandırma hesabındaki ödemeler belirlediğiniz 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 bildirimleri 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ı", bazı müşterilerin yeni kullandıkça öde fiyatlandırma planımıza geçmelerine yardımcı olmak için oluşturulmuştur. Bu geçiş hesabı sayesinde Google, bu müşterilere tek seferlik bir kredi sağlamıştır. Böylece Google Haritalar Platformu'nu 200 ABD doları değerindeki ücretsiz katmanla sınırlı olacak şekilde kullanmaya devam edebilirler. Bu sınır aşıldığında faturalandırma hesabı kapanır ve hizmete erişimi kaybedersiniz. Hizmet kesintisi yaşamamak için kendi faturalandırma hesabınızı ayarlamanızı ve aylık 200 ABD doları değerindeki ücretsiz katmanı kullanmaya devam etmenizi öneririz. Projenize ait faturalandırma hesabını değiştirmek için:

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

Neden kota sınırım günde 1 istek olarak ayarlı? Bu sınırı nasıl artırabilirim?

Projenize faturalandırma hesabı oluşturup eklemediyseniz Haritalar Platformu 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.

Günlük faturalandırma sınırı oluşturup oluşturduktan sonra günlük kota sınırınız kaldırılır. Cloud Console'da beklenmedik harcamaları önlemek için bir sınır ayarlamaya karar verebilirsiniz.

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

Google'ın hesabınızın birden fazla faturalandırma hesabı kullandığını tespit ettiği için bu bildirimi aldınız. Bu, Google Haritalar Platformu Hizmet Şartları'nın 3.2.4 bölümünde açıklandığı üzere Google'ın şartlarını ihlal etmektedir. Bu şartlar kapsamında, birden fazla faturalandırma hesabı oluşturulması yasaktır. Daha fazla bilgi edinmek için Faturalandırma Hesabı İhlaliyle İlgili SSS bölümünü inceleyin.

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 kullanışınızda isteğinizi doğrulamak için bir API anahtarı eklemeniz gerekir. Google Haritalar Platformu; Android, iOS veya web uygulamalarında ve HTTP web hizmetleri üzerinden kullanılabilir.

API Anahtarı:

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

Dijital İmza:

Dijital imza, size Google tarafından sağlanan bir URL imzalama gizli anahtarı kullanılarak oluşturulur. Dijital imzalar Maps Static API ve Street View Static API ile 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 uygulama kısıtlaması ekleyebilirsiniz. Bir anahtar, kısıtlandıktan sonra 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.
- IP adresleri (bireysel sunucular): Web hizmeti API'leriyle kullanılması içindir.
- HTTP yönlendirenler (web siteleri): Web API'leriyle kullanım içindir.
- Android uygulama kısıtlaması (paket adı ve parmak iziyle) - Android için Haritalar SDK'sı ile kullanım.
- iOS uygulama kısıtlaması (iOS paket tanımlayıcısına göre) iOS için Haritalar SDK'sı ile kullanılır.
API anahtarına API kısıtlaması da ekleyebilirsiniz. Daha fazla bilgi için API anahtarı alma, ekleme ve kısıtlama bölümüne bakın.

Aşağıdaki tabloda, her bir Google Haritalar Platformu API'si/SDK'sı için anahtar/kimlik bilgileri ile 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ıtlaması olan API anahtarı¹
Haritalar Statik API	HTTP yönlendirmesi kısıtlaması olan API anahtarı¹ + Dijital İmza²
Street View Static API	HTTP yönlendirmesi kısıtlaması olan API anahtarı¹ + Dijital İmza²
Haritalar Yerleştirme API'si	HTTP yönlendiren kısıtlaması olan API anahtarı¹
Adres Doğrulama API'si	IP adresi kısıtlaması olan API anahtarı¹
Directions API	IP adresi kısıtlaması olan API anahtarı¹
Mesafe Matrisi API'si	IP adresi kısıtlaması olan API anahtarı¹
Elevation API	IP adresi kısıtlaması olan API anahtarı¹
Geocoded API	IP adresi kısıtlaması olan API anahtarı¹
Geolocation API	IP adresi kısıtlaması olan API anahtarı¹
Yerler API'si	IP adresi kısıtlaması olan API anahtarı¹
Roads API	IP adresi kısıtlaması olan API anahtarı¹
Routes API	IP adresi kısıtlaması olan API anahtarı¹
Saat Dilimi API'si	IP adresi kısıtlaması olan 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 Maps Static API ve Street View Static API için dijital imza gerekebilir. Kullanımdan bağımsız olarak, isteklerinizi doğrulamak için hem API anahtarı hem de dijital imza kullanmanızı öneririz.

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ına sahip web hizmeti API'lerinden birini kullanıyorsanız istekleriniz şu hata mesajıyla başarısız olur: "API anahtarları bu API ile kullanıldığında yönlendiren kısıtlamaları içermeyebilir." IP adresi kısıtlamaları olan bir API anahtarı kullanmanız gerekir.

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 birlikte ayrı bir anahtar ekleyin. Yeni API anahtarı ekleme hakkında bilgi edinin.

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

HTTP yönlendirmesi kısıtlaması olan bir API anahtarını IP adresi kısıtlamasına geçirmek 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, API anahtarları listesinden anahtarın ayrıntılarını düzenlemek için 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 ekleyin ve ardından 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 bir sürümünde başlatılan değişiklikleri nasıl bulabilirim?

Haritalar API'larının çoğuna ilişkin sürüm değişikliği bilgilerini aşağıdaki bağlantılarda bulabilirsiniz:

Ayrıca, Google Haritalar Platformu Sorun İzleyicisi'ni kullanarak belirli bir hatanın hangi sürümde kullanıma sunulduğunu ve düzeltildiğini de kontrol edebilirsiniz:

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

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

API'yi yüklerken geri çağırma parametresini belirtmeniz yeterlidir. Daha fazla bilgi ve örnek kod, Maps JavaScript API dokümanlarının Başlarken bölümünde bulunabilir.

Google Haritalar Platformu ürünlerinin İngilizce dışında bir dilde gösterilmesini 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, istekte bulunurken açıkça bir dil ayarlamanıza olanak tanır. Her bir API'nin dokümanlarında dili ayarlama hakkında daha fazla bilgi bulabilirsiniz:

Desteklenen Diller:

Google genellikle desteklenen dilleri 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
öö	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	Malayca
my	Burmaca	ml	Malayalam
ca	Katalanca	mr	Marathi
zh	Çince	mn	Moğolca
zh-CN	Çince (Basitleştirilmiş)	ne	Nepalce
zh-HK	Çince (Hong Kong)	hayır	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	Urdu
hu	Macarca	uz	Özbekçe
:	İzlanda dili	vi	Vietnamca
id	Endonezce	zu	Zulu
it	İtalyanca

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

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

Maps JavaScript API, Maps Static API ve Web Service API'lere güvenli (HTTPS) bağlantılar üzerinden erişilebilir. API'ye SSL üzerinden nasıl erişileceğiyle ilgili bilgi için lütfen ilgili API'nin dokümanlarına 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 hata bildirme veya yeni özellik isteğinde bulunma.

Hata olabileceğini düşündüğünüz bir davranışla karşılaşırsanız lütfen öncelikle bunu ilgili forumda açıklayın. Böylece diğer geliştiriciler bu hatayı doğrulayabilir ve kodunuzla ilgili olası sorunları eleyebilir.

Özellik isteğinde bulunmak istiyorsanız lütfen önce ilgili özelliklerle ilgili bir çözümün mevcut olmadığını onaylamak için lütfen ilgili forumda özelliği yükseltin.

Yeni bir hata tanımladığınızı veya gereksinimlerinizin Google Haritalar Platformu ürünlerinin mevcut işlevi tarafından karşılanamayacağını doğruladıktan sonra lütfen Google Haritalar Platformu Sorun İzleyici'yi kullanarak hatanızı veya özellik isteğinizi bildirin.

Sorun İzleyici'ye bir hata veya özellik isteği eklemeden önce, söz konusu hatanın veya özelliğin eklenip eklenmediğini kontrol ettiğinizden emin olun. Sorun varsa ilgi alanınızı kaydetmek ve güncellemeler hakkında bildirim almak 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ı hesaplama ve hizmet 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 bilgilerin geri kalanıyla birlikte günlüğe kaydedilmez.

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

Google'ın Geliştirici İlişkileri Ekibi, programcılara yönelik ortak çalışmayla düzenlenmiş bir soru ve cevap sitesi olan Stack Overflow'da yer alır. Burası, Google Haritalar uygulamaları geliştirme ve sürdürmeyle ilgili teknik sorular sormak için idealdir. Stack Overflow hakkında soru sorma hakkında daha fazla bilgiyi Destek sayfasında bulabilirsiniz.

Yardım talep ederken en iyi sonuçları elde etmek için lütfen aşağıdakileri aklınızda bulundurun:

Mevcut tartışmalarda arama yapın. Başka bir kullanıcı da benzer bir sorunla karşılaşmış ve bir düzeltme bulmuştur.
Mümkünse sitenizin bağlantısını gönderin. Kod snippet'lerini, yalnızca kod online olarak kolayca görüntülenemiyorsa yayınlayın.
Bu sorunu giderme konusunda faydalı olabilecek tarayıcı sürümleri, hatalar ve diğer tüm bilgiler dahil olmak üzere alakalı 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ıyla ilgili açıklamaları bulmak için lütfen aşağıdaki bağlantıları inceleyin:

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

Belirli durumlarda, "yalnızca geliştirme amaçlı" filigranına sahip koyu renkli bir harita veya "negatif" Street View resmi gösterilebilir. Bu davranış genellikle API anahtarı veya faturalandırmayla ilgili sorunları gösterir. Google Haritalar Platformu ürünlerini kullanabilmek için 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:

API anahtarı kullanıyor musunuz?

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

Bir API anahtarı, Maps JavaScript API'yi yüklemek için kullanılan URL'de key parametresi olarak aktarılır. API anahtarı kullanıp kullanmadığınızı kontrol etmek için kullanabileceğiniz seçenekler aşağıda verilmiştir:

Google Haritalar Platformu API Kontrolü Chrome uzantısını kullanın. Böylece 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ıkla ilgili ayarları kontrol edin ve API anahtarı seçeneğini arayın.
Tarayıcınızdaki hataları kontrol edin. Aşağıdaki mesajları görüyorsanız API anahtarınızı doğru kullanmıyorsunuzdur:

Google Maps JavaScript API uyarısı: NoApiKeys
Google Haritalar JavaScript API'si hatası: MissingKeyMapError

Web geliştiricileri için:

Uygulamanızın kaynak koduna erişiminiz varsa Maps JavaScript API'yi yüklemek için kullanılan <script> etiketini bulun. Maps JavaScript API'yi yüklerken API kodunuzu aşağıdaki kodda YOUR_API_KEY ile değiştirin.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Web sitenizin oluşturduğu ağ trafiğini tarayıcıda kontrol edin. Chrome'da bu, 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 yolunun altında yer alır. Burada, isteklerin key parametresini kullanıp kullanmadığını onaylayabilirsiniz. Ağ sekmesini görüntülerken maps/api/js tarihine kadar ağ trafiğinizi filtrelemek yararlı olabilir.

Hayır, API anahtarı kullanmıyorum.

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şlama başlıklı makaledeki tüm talimatları uygulayın.
Başlayın

Evet, bir API anahtarı kullanıyorum.

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

Projenize bağlı bir faturalandırma hesabı var mı?

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

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

Google Haritalar Platformu > Kimlik bilgileri bölümünün altındaki sol kenar çubuğundan erişilebilen Kimlik bilgileri bölümüne gidin.
Şu anda web sitenizde kullandığınız API anahtarının listede bulunup bulunmadığını kontrol edin. Aksi takdirde farklı bir projeye geçin ve projedeki kimlik bilgilerini kontrol edin.
API anahtarınız için projeyi bulamıyorsanız bu projeye erişiminizi kaybetmiş olabilirsiniz. Kuruluşunuzdaki kullanıcılardan yardım isteyin. Orijinal proje bulunamıyorsa şunları yapmalısınız:
1. Yeni proje oluşturun. Bunun için projeler listesinden Yeni Proje'yi veya Kaynak Yöneticisi sayfasından Proje Oluştur'u seçebilirsiniz.
2. Yeni bir API anahtarı oluşturma. Bu işlem Kimlik Bilgileri sayfasında yapılabilir. Kimlik bilgisi oluştur'u tıklayıp 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 bir faturalandırma hesabı eklenmedi.

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ı eklenmiş.

İ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 günlük olarak uygulanan bir sınır var mı?

API'lerinizden herhangi birinde günlük sınır belirlediyseniz ve bu durum beklenmedik artışları önlemek için yaygın bir durumdur ve 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 sayfada:

İstenirse bir proje seçin.
Listeden bir API seçin, 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ılmak üzere tasarlanmış web hizmetleriyle (Geocoded API ve diğer Web Hizmeti API'leri gibi) kullanılabilir. Bu web hizmetlerinin çoğunun Maps JavaScript API içinde eşdeğer hizmetleri vardır (ö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üvenlik altına alınabilecek ayrı bir API anahtarı oluşturmanız gerekir (API anahtarı alma, ekleme ve kısıtlama bölümüne bakın).

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

Bu hata kodları aşağıdaki nedenlerden herhangi biri yüzünden döndürülebilir:

İstekte API anahtarı eksik.
Sağlanan API anahtarı geçersiz.
Projeye eklenmiş bir faturalandırma hesabı yok.
Kendi kendini sınırlayan kullanım sınırı aşıldı.
Sağlanan ödeme yöntemi artık geçerli değil (örneğin, 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 bir 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ı edinin.
Günlük sınırınızı (varsa) artırmak için 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 ile karşılaşırsanı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 adresini ziyaret edin.

"Bu IP, site veya mobil uygulama bu API anahtarını kullanma yetkisine sahip değil." hatasını nasıl çözebilirim?

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, bir isteği deniyor.
API anahtarınızda HTTP yönlendireni (web sitesi) kısıtlamalarını etkinleştirdiniz ve yetkisiz bir yönlendiren, isteği deniyor.
Bir 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 ve tanınmayan bir iOS uygulamasının istek göndermek için kullandığı iOS uygulamalarından gelen istekleri kısıtladınız.
Önceden, HTTP yönlendirme kısıtlamalarına sahip bir API anahtarıyla web hizmeti API'lerinden herhangi birini kullandıysanız bu hatayı alabilirsiniz. Bu API'lere yapılan istekler, IP adresi kısıtlamaları olan bir API anahtarıyla tanımlanmalıdır. Anahtar kısıtlama türünüzü HTTP yönlendirici 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ı'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:

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 dahil olmak üzere kimlik bilgisi ayrıntılarını, API anahtarları listesinde görüntülemek için anahtarın adını tıklayın.
Seçilen API anahtarının tüm kimlik bilgileri (anahtar için ayarlanan tüm kısıtlamalar dahil) görüntülenir. Buradan, kısıtlamaları gereken şekilde değiştirebilir, silebilir veya güncelleyebilirsiniz.

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

HTTP yönlendirenle sınırlı bir API anahtarı kullanarak web hizmeti API'lerinden herhangi birini kullanıyorsunuz. Güvenlik nedeniyle, web hizmeti API'lerinde IP adresleri ile kısıtlanmış API anahtarları kullanılmalıdır. Anahtar kısıtlama türünüzü HTTP yönlendirici kısıtlamasından IP adresi kısıtlamasına geçirin veya anahtarınız Maps JavaScript API ile zaten 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" adı verilir. Maps JavaScript API, coğrafi kodlama hizmeti gerçekleştirmek için 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 sunar.

Coğrafi kodlama hangi ülkelerde kullanılabilir?

Şu anda Google Haritalar Platformu'nun coğrafi kodlama sistemleri tarafından desteklenen ülkeleri görmek için lütfen Google Haritalar kapsam verileri sayfasını inceleyin.

Coğrafi kodlamalı konumların doğruluğu ülkeye göre değişebilir. Bu nedenle, başvurunuzla ilgili yeterli düzeyde 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ılarıyla olan sözleşmelerimize bağlı olduğunu, dolayısıyla 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 kodlama ve Google Haritalar coğrafi kodlama aracı bazen farklı veri kümeleri kullanır (ülkeye bağlı olarak). API coğrafi kodlama aracı zaman zaman yeni verilerle güncellenir. Bu nedenle, zaman içinde sonuçların değiştiğini veya iyileştirildiğini görebilirsiniz.

Coğrafi kodlama sorgularımı, başarılı isteklerin sayısını en üst düzeye çıkaracak şekilde nasıl biçimlendirmeliyim?

Coğrafi kodlama, açık adresleri coğrafi koordinatlarla eşleştirmek için tasarlanmıştır. Bu nedenle, bir 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, söz konusu ülkenin ulusal posta hizmeti tarafından kullanılan biçime göre belirtin.
İşletme adları, birim numaraları, kat numaraları veya daire numaraları gibi ek adres öğeleri, ilgili ülkenin posta hizmeti tarafından tanımlandığı şekilde adrese dahil edilmez. Aksi takdirde ZERO_RESULTS ile yanıt alabilirsiniz.
Artı kodlarını burada gösterildiği gibi biçimlendirin (artı işaretleri %2B ile URL çıkışlı, boşluk URL'si %20 şeklindedir.):
- Global kod, 4 karakterden oluşan bir alan kodu ve 6 veya daha uzun yerel koddur (849VCWC8+R9 849VCWC8%2BR9).
- Bileşik kod, açık bir konuma sahip 6 karakter veya daha uzun bir yerel koddur (CWC8+R9 Mountain View, CA, ABD CWC8%2BR9%20Mountain%20View%20CA%20USA).
Mümkün olduğunda bina adının yerine binanın bina numarasını kullanın.
Mümkün olduğunda çapraz sokakları belirtmek yerine sokak numarası adresini kullanın.
Yakındaki önemli noktalar gibi "ipuçları" vermeyin.

Coğrafi kodlama için numaralandırılmış bir otoyolda ABD adresini nasıl biçimlendirmeliyim?

Google Haritalar Platformu'nun coğrafi kodlama aracı, ABD numaralı otoyolların adreslerde aşağıdaki gibi belirtilmesini gerektirir:

İlçe Yolları: Yol numarası NNN olan "Co Road NNN". "Co Road 82"
Otoyollar: "State NNN" Bu kısımda Eyalet eyaletin tam adıdır, NNN ise otoyol numarasıdır. "California 82"
ABD Otoyolları: NNN otoyol numarasını belirtir. "U.S. NNN" ör. "U.S. 101"
ABD eyaletleri: "Interstate NNN" Burada NNN eyaletler arası numaradır. Ör. "Interstate 280"

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

Farklı coğrafi kodlama stratejilerinin avantajlarını ve dezavantajlarını ayrıntılarıyla gösteren Coğrafi Kodlama Stratejileri dokümanını inceleyin.

Google Haritalar Platformu ile arabayla yol tariflerini nasıl sağlarım?

Routes API ve Directions API'nin Compute Routes hizmeti, tek ve çok aşamalı yolculuklar için arabayla yol tarifleri sunar. Yönlendirme seçenekleri, bir ulaşım şekli (araba sürmek), tek veya bir dizi rota ve kısıtlamalar (ücretli yol 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'si, google.maps.DirectionsService sınıfı üzerinden 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ı uygulamalarda Java, Python, go ve Node.js istemci arayüzleri aynı işlevleri sağlar. İstemci kitaplıkları hakkında daha fazla bilgi için Directions API istemci kitaplıkları başlıklı makaleye bakın.

Hangi ülkelerde arabayla yol tarifi sunuluyor?

Şu anda Google Haritalar Platformu ürünlerinde arabayla yol tarifinin desteklendiği ülkeleri görmek için Google Haritalar kapsam verileri sayfasını inceleyin. Arabayla yol tarifi verilerinin kullanılabilirliğinin veri sağlayıcılarıyla olan sözleşmelerimize 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 Remote Malast API, Japonya'dakiler hariç tüm Google Transit iş ortaklarını destekler.

Maps JavaScript API'de desteklenen KML ve GeoRSS özellikleri hangileridir?

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

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

KmlLayer sınıfının kullanıldığı KML'lerin gösterilmesiyle ilgili boyut ve karmaşıklık sınırları burada açıklanmıştır.

Harita üzerinde 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ı, KML dosyalarını görüntülemek üzere 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şmek için kimlik doğrulaması 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, üçüncü taraf JavaScript kitaplıklarını kullanarak KML'yi istemci tarafında oluşturmanızı öneririz. KML dosyası tarayıcı tarafından analiz edildiğinden, performans KmlLayer sınıfı kullanımından daha düşük olabilir.

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

Maps Static API tarafından desteklenen işaretçi veya yol köşesi sayısı için bir sınır yoktur. Özel simgeler kullanılırken istek başına beş benzersiz simge belirtilebilir ancak bunların her biri haritada birden çok 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 göre belirtilebilecek işaretçi ve yol köşesi sayısını kısıtlar. Kullanılan ondalık basamak sayısının Dünya'daki doğrulukla nasıl ilgili olduğu hakkında bilgi edinmek için Ondalık Dereceler ile ilgili Wikipedia makalesine göz atı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?

Yanlış veya eksik harita bilgileri için Google Haritalar üzerinden geri bildirim gönderin. Örneğin:

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

Bir yeri veya işletme girişini düzeltmek için düzenleme önerin.

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

Kritik veya zamana duyarlı istekler için düzeltilmesi gerekenlerle ilgili ayrıntıların bulunduğu bir destek kaydı oluşturun.

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

Bazı istemci taraflı özellikler, Qwiklab'i (Hizmet Düzeyi Hedefi) hesaplamak amacıyla başarıyı veya başarısızlığı raporlamaya yöneliktir. Bu bilgiler Google'a, maps.googleapis.com/maps_api_js_slo/log numaralı telefondan Qwiklabs bilgilerinin günlüğe kaydedildiği görüşmelerde gönderilir. Bu bilgiler, kullanımdaki Haritalar JavaScript API'sinin başarı durumunu, gecikmesini ve sürümünü/kanalını içerir. Aramalar performans için toplu olarak işlenebilir. Bu çağrıların tarayıcı düzeyinde engellenmesini önlemek için İçerik Güvenliği Politikanızda maps.googleapis.com uygulamasına izin vermeniz gerekebileceğini lütfen unutmayın. Örneğin: HTTP üst bilgileri ile 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ı

Hatayı nasıl çözebilirim: kGMSPlacesRateLimitExceeded?

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ıldı ve artık kullanılamıyor. En kısa sürede uygulamanızı güncel sürüme geçirerek uygulamanızı güncelleyin. Ayrıntılar için taşıma rehberine göz atın.

iOS 8.x yüklü bir cihazda hata ayıklama sırasında hata alıyorum. What should I do?

iOS 8.x çalıştıran cihazlarda hata ayıklama sırasında sorun yaşıyorsanız çalıştırdığınız XCode şemasında GPU çerçeve yakalamasını devre dışı bırakmak için şu adımları uygulayın:

XCode'da Ürün, Şema, Şemaları Yönet'i seçin.
Bir şema seçin ve Düzenle... seçeneğini belirleyin.
GPU Kare Yakalama seçeneğini Devre dışı olarak ayarlayın. Bu seçeneğin tüm cihazlarda kullanılamayabileceğini unutmayın.

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

iPhone X iPhone'lardan itibaren yuvarlatılmış köşeleri olan bir ekran şekli, cihaz sensörünün tepesindeki çentik ve ekranın alt kısmındaki Ana ekrana erişim göstergesi bulunur. Apple, iOS 11.0 SDK'sı itibarıyla Safe Area API'yi ekleyerek geliştiricilerin, öğeleri yeni ekran şeklinin kırpılacağı güvenli bir alana yerleştirmesine olanak tanıyor.

Google Haritalar iOS SDK'sında, iç mekan seçici ve sorun bildir 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 seçicisi çentik veya ana sayfa düğmesi göstergesiyle kırpılabilir.

Google Haritalar iOS SDK'sının 2.5 sürümünde bu düzen sorunları otomatik olarak düzeltilmiştir. Uygulamanız bir iPhone X veya sonraki sürümlerde kullanıldığında, görsel öğelerin kırpılmaması için GMSMapView ve GMSPanoramaView'daki dolgu artırılır.

Varsayılan olarak, her zaman dolgunuzu ekleriz. Google Haritalar iOS SDK'sı, dolgunun güvenli alanın içinden doldurulduğunu varsayar. Arayüzünüzü her şeyin güvenli alanda bulunduğu varsayımıyla tasarlarsanız bu işlem ekstra çaba sarf etmeden işe yarar.

Varsayılan düzenlemeyle çalışmayan bir arayüz tasarladıysanız GMSMapView için fillAdjustDavranış adlı yeni bir özelliği kullanıma sunduk. GMSMapView artık üç dolgu ayarlama davranışından birini seçmenize izin veriyor: "Her zaman" (varsayılan), "Otomatik" ve "Hiçbir zaman".

GMSMapView, "Her zaman" dolgu davranışını kullanacak şekilde ayarlanmışsa dolguya her zaman güvenli alan girişlerini ekler. Bu, tüm arayüzü güvenli alanın kenarlarından geldiği varsayımıyla arayüzü tasarlamanıza olanak tanır. Bu, varsayılan değerdir.

GMSMapView, "Otomatik" dolgu davranışını kullanacak şekilde ayarlanmışsa her zaman daha büyük dolgu veya güvenli alan uzantısı seçilir. Bu, ekran kenarından dolgu eklemenize olanak tanırken tüm öğelerin her zaman güvenli alanda kalmasını sağlar.

GMSMapView, "Hiçbir zaman" dolgu davranışını kullanacak şekilde ayarlanmışsa dolguya güvenli alan girişlerini hiçbir zaman eklemez. Bu, 2.5 sürümünden önceki davranıştır ve dolgunuz zaten güvenli alanı dikkate alıyorsa veya diğer davranışlarınız arayüzünüzle iyi çalışmıyorsa faydalı 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 dolgu olmadığı ve GMSPanoramaView'un tüm görsel öğelerin güvenli alan içinde olmasını sağlamak için gereken dolguyu her zaman uygulayacağı anlamına gelir.

Android için Google Haritalar SDK'sı

Hatayı nasıl çözebilirim: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?: Bu hatayı görüyorsanız Yerler SDK'sının Android için 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. En son sürümü kullanmak için lütfen en kısa sürede uygulamanızı güncelleyin. Ayrıntılar için taşıma rehberine göz atın.

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

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

adb'nin yüklü olduğundan emin olun. Aksi takdirde buradaki kılavuzu uygulayabilirsiniz.
Sorunu gösteren uygulamayı veya Android emülatörünü 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" ç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, günlüğü bir metin dosyasına şu eki ekleyerek çıkarabilirsiniz: > 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 başvuruluyor.
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 Hizmet bağımlılıkları build.gradle dosyasına dahil edilmez.

URL imzalama

URL'leri JavaScript kullanarak imzalayabilir miyim?

URL'lerinizin imza sırrınızı son kullanıcılara göstereceğinden, URL'leri JavaScript kullanarak imzalamanızı kesinlikle önermeyiz. Bu nedenle, imzalar yalnızca sunucu tarafı bileşenler tarafından oluşturulmalıdır.

Maps API web hizmeti isteklerim için neden HTTP 403 Yasak yanıtı alıyorum?

HTTP 403 yanıtı, muhtemelen bu istek için imzanın doğrulanamamasından dolayı bir izin sorununu belirtir. Bunun nedeni aşağıdakilerden biri olabilir:

Bir imza belirtildiği halde bu istek için yanlış.
İstek bir Google Haritalar Platformu Premium Planı 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.
Bir imza belirtilmiş ancak ilişkili Google Haritalar Platformu Premium Plan API anahtarı belirtilmemiş.