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

Google Haritalar Platformu Hakkında SSS

Başlarken

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ç teklif 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:

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.

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

İlgilendiğiniz API veya SDK ile ilgili Genel Bakış, Geliştirici ve Başlangıç kılavuzlarına göz atı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 verileri yayınlıyor ve uluslararası kapsamımızı genişletiyor. En güncel kapsam bilgileri için Google Haritalar kapsam verilerine bakın. Sayfanın üst kısmındaki filtre kutusunu kullanarak verileri filtreleyebilirsiniz. Veri sağlayıcılarla yapılan lisans sözleşmeleri değişirse kapsam verilerinin değişebileceğini lütfen unutmayın.

Ayrıca şu makaleleri inceleyebilirsiniz:

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

Google Haritalar Platformu ürünlerini kullanmadan siteme Google Haritalar'ı ekleyebilir miyim?

Evet. Google Haritalar artık herhangi bir programlama veya Google Haritalar Platformu kullanımı olmadan görüntülediğiniz haritayı web sitenize ya da blogunuza yerleştirme olanağı sunuyor. Daha fazla bilgiye buradan ulaşabilirsiniz.

Haritalar uygulamalarını mobil cihazlara 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.

Maps JavaScript API, mobil cihazlara hitap edecek şekilde 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.

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

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

Maps JavaScript API ve Maps Embed API aşağıdaki web tarayıcılarını destekler:

Masaüstü

IE modu hariç Microsoft Edge'in (Windows) mevcut sürümü.
Firefox'un en son iki büyük kararlı sürümü (Windows, macOS, Linux).
Chrome'un en son iki büyük kararlı sürümü (Windows, macOS, Linux).
Safari'nin (macOS) en son iki kararlı ana 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 WebView.

iOS

iOS'un güncel ve önceki ana sürümlerindeki Mobil Safari.
iOS'in güncel 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 desteklenmez. Bunun nedeni, baskı desteğinin yaygın olarak kullanılan tarayıcılarda tutarlı olmamasıdır.

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

Çeşitli Google Geo geliştirici teklifleriyle ilgili güncel haberler için Google Haritalar Platformu Blogu'na abone olmanız gerekir.

Teknik Destek Ekibi ile nasıl iletişime geçebilirim?

Mevcut destek seçenekleri hakkında bilgi edinmek için Google Haritalar Platformu Destek ve Kaynakları başlıklı makaleyi inceleyin.

Teknik destek ne zaman kullanılabilir?

Destek ekibi, "hizmet kullanılamıyor" sorunlarında bölgesel tatiller hariç hafta içi her gün Tokyo saatiyle pazartesi günleri 09:00 ile Cuma günleri 17:00 arasında 24 saat hizmet vermektedir.

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

Google Hesabınıza (ör. cemal@şirketim.com veya cemal@gmail.com) erişimi kaybettiyseniz ş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 makalesini inceleyin.

Not: Bir G Suite hesabına erişimi geri yüklemek için kuruluş yöneticinizden hesabı silmeyi geri almasını isteyin.

Belirli bir projeye erişimi nasıl kurtarabilirim?

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

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

Proje sahibini 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çin ve sizi proje sahibi olarak eklemelerini isteyin.
Mevcut proje sahiplerinden hiçbirini tanımıyorsanız: Proje sahibinin kim olduğunu bilmiyorsanız veya proje sahibi müsait değilse projeyi kurtarmayla ilgili ek seçenekleri keşfetmek için destek ekibiyle iletişime geçin.

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

Google Hesabınıza erişimi 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çerek yeni Google Hesabınızı projeye eklemesini isteyin.

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

Yeni Arm tabanlı Mac'lerde geliştirme yapmak mümkündür ancak bunun için fiziksel bir iOS cihazda derleme ve çalıştırma gerekir. Simülatörlerde geliştirme için daha fazla destek ekleme çalışmalarımız devam ederken 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ı'nı şu adresten inceleyebilirsiniz:

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

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

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

Ancak Google Haritalar Platformu'nun bazı kullanımlarını görmek istemeyiz. Örneğin, bir şehirde yasa dışı uyuşturucu satın alabileceğiniz yerleri veya başka yasa dışı etkinlikleri gösteren haritalar. Kullanıcıların gizliliğine de saygı duyduğumuz için Google Haritalar Platformu, kişilerle ilgili gizli bilgileri tanımlamak için kullanılmamalıdır.

Uygulamanızı geliştirip kullanıma sunmadan önce, uygulamanızın Google Haritalar Platform Hizmet Şartları'na uygun olup olmadığını belirlemek için kendi danışmanınızla görüşmeniz gerekir. Google mühendisleri yalnızca teknik yardım sunabilir ve yasal tavsiyede bulunmaya yetkili değildir. Google, hizmeti kullanmanızı herhangi bir zamanda askıya alma veya feshedme hakkını saklı tutar. Bu nedenle lütfen Haritalar API'leri Şartları'nı dikkatlice okuyun.

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

Harita karolarına veya uydu görüntülerine Google Haritalar Platformu dışındaki herhangi bir mekanizmayla (ör. kendi harita oluşturma API'nizi oluşturma veya toplu karo indirme komut dosyası kullanma) erişemezsiniz. Uygulamanız, Google Haritalar Platformu dışından karolara erişirse karolara 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 anlık verilerin (takip) gösterilmesi konusunda herhangi bir kısıtlama yoktur.

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

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

Maps JavaScript API yalnızca b 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şimli uygulamalarla kullanılabilir. Daha fazla bilgi için Google Haritalar Platformu Hizmet Şartları'na bakın.

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

Uygulamanız elektronik veya basılı biçimde bir doküman oluşturuyorsa dokümana resimler dahil olmak üzere Google Haritalar Platformu'ndan hiçbir veri dahil edilemez. Daha fazla bilgi için lütfen Google Haritalar Platformu Hizmet Şartları'nın "Kazıklama Yasağı" bölümüne bakın.

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

Bu veriler artık toplanmıyor. indexing parametresinin kullanımı kullanımdan kaldırılmıştır ve artık herhangi bir etkisi yoktur. Artık kapsam dışında kalmayı açıkça seçmeniz gerekmiyor 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 merkezimizdeki talimatları uygulayın.

Maps Static API'yi kullanarak web sitemde depolayıp sunacağım bir harita resmi oluşturabilir miyim?

Maps Static API kullanılarak oluşturulan resimlerin kopyalarını web sitenizden depolayamaz ve yayınlayamazsınız. Statik resim gerektiren tüm web sayfaları, tüm harita resimlerinin web sayfasının HTML içeriğinde görüntülenmesi ve Google tarafından doğrudan 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ğlamalıdır.

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 yükseltme yapabilir?

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

Google Haritalar Platformu'nda kullanım sınırı var mı?

Google Haritalar Platformu ürünlerine gönderebileceğiniz istek sayısıyla ilgili günlük maksimum sınır yoktur. Tek kullanım sınırı, dakika başına maksimum sorgu sayısıyla (QPM) ilgilidir.

Mesafe matrisi için sınır, istemci tarafı ve sunucu tarafı sorgularının toplamı olarak hesaplanan dakika başına etkinlik (EPM) cinsinden belirlenir.

Rotalar:Rota Matrisini Hesapla işlevi için sınır, dakikada öğe sayısı (EPM) cinsindendir. Bir istekteki öğe sayısı şuna eşittir: (kaynak sayısı çarpı hedef sayısı).

Gezinme SDK'ları için bir istekteki her hedef ayrı bir sorgu olarak sayılır.

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 PPM
Aerial View: Lookup Video	180 QPM ve 100.000 QPD
Havadan Görünüm: Video Oluşturma	100 QPM ve 100 QPD
Hava Kalitesi	6.000 PPM
Yol tarifi	3.000 PPM
Mesafe Matrisi	60.000 EBM
Dinamik Haritalar	30.000 PPM
Rakım	6.000 PPM
Coğrafi Kodlama	3.000 PPM
Coğrafi konum	6.000 PPM
Map Tiles API: 2D Parçalar ve Street View Parçaları	Dakika başına 6.000 sorgu ve 15.000 sorgu noktası
Map Tiles API: Gerçekçi Fotoğraf 3B Parçalar	10.000 QPD
Map Tiles API: Gerçekçi Fotoğraf 3B Parçalar: Oluşturucu	12.000 PPM
Navigasyon: Hedef isteklerini ayarlama	30.000 BGBM
Yerler	6.000 PPM
Polen	6.000 PPM
yollar	30.000 BGBM
Rotalar: Rotaları Hesaplama	3.000 PPM
Güzergahlar: Güzergah matrisini hesaplama	3.000 EBM
Güneş enerjisine bağlı	600 PBM
Statik Haritalar	30.000 BGBM
Sokak Görünümü Görüntü API'sı	30.000 BGBM
Saat Dilimi	30.000 BGBM

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

Google Haritalar Platformu ürünleri, standart Google Haritalar Platformu Hizmet Şartları'na uygun şekilde 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 Sayfası'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 başlıklı makaleyi inceleyin.

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

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

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

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

Statik (etkileşimsiz) bir Street View panoramasını yerleştirmek için Street View Static API'ye yapılan her istek için statik Street View panoraması ücretlendirilir.
Android veya iOS uygulaması için Haritalar SDK'sı ve Maps JavaScript API'deki bir panorama nesnesi örneklemesi her oluşturulduğunda dinamik Street View panoraması için ücret alınır.

Bir web sayfası veya uygulama bir harita, statik harita resmi ya da Street View panoraması yükledikten sonra, kullanıcının bu öğeyle yaptığı kaydırma, yakınlaştırma veya harita katmanlarını değiştirme gibi etkileşimler, ek harita yüklemeleri oluşturmaz veya kullanım sınırlarını etkilemez.

İşaretleyici eklemek ek harita yüklemesi oluşturmaz ancak raptiye konumunun nasıl belirlendiğiyle ilgili ücretler (ör. "google.maps.Map()` sınıfının yüklenmesi veya yeniden yüklenmesi) doğurabilir.

Kullanımımı nasıl izleyebilirim?

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

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

Bir projenin tamamına ait trafik raporunu ve faturalandırma bilgilerini görmek için aşağıdaki adımları uygulayın:

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

Daha fazla bilgi edinmek için Google Haritalar Platformu Raporları'nın yanı sıra API Kullanımınızı İzleme ve API Kullanımını Sınırlama başlıklı makaleleri inceleyin.

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

Belirli bir Google Haritalar Platformu ürününün QPM 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 QPM sınırlarını aşarsanız veya hizmeti başka bir şekilde kötüye kullanırsanız isteklerde belirli bir hata mesajı döndürülür. Sınırları aşmaya devam ederseniz Google Haritalar Platformu'na erişiminiz engellenebilir.

Not: Web hizmeti API'lerinden dördünün Maps JavaScript API'de eşdeğer istemci tarafı hizmeti vardır: Directions, Distance Matrix, Elevation ve Geocoding.

Kullanım sınırı 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 mesaj, web hizmetinin normal yanıtlar sağlamaya son verdiğini ve daha fazla kullanıma izin verilene kadar yalnızca OVER_QUERY_LIMIT durum kodunu döndürmeye başladığını gösterir. Uygulamanız dakikada çok fazla istek gönderdiği için hata alındıysa bu durum birkaç saniye içinde gerçekleşebilir.

SBM 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ı veya kotanızın artırılmasını istemeyi düşünebilirsiniz. Daha fazla bilgi için Optimizasyon Kılavuzu'na bakın.

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

Evet. Ancak uygulamanızın kullandığı Google Haritalar Platformu API'lerinin kullanım sınırlarını incelemenizi öneririz.

Web sitem veya uygulamam aniden popüler olursa haritalarımın çalışması durur mu?

Faturalandırma hesabınız varsa ve aylık 200 ABD doları olan ücretsiz kullanım sınırını aşarsanız ve faturalandırma hesabınızda geçerli bir ödeme yöntemi (kredi kartı, banka havalesi vb.) yoksa geçerli bir ödeme yöntemi ekleyene kadar API çalışmayı durdurur.

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

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

Google Haritalar Platformu'nu kullanmanın maliyeti nedir?

API başına maliyete genel bakış için Fiyatlandırma Sayfası'na bakın. Uygulamanız, aylık 200 ABD dolarına kadar istek veya harita yükleme hacmi oluşturuyorsa 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ızdan ücret alınır. Daha fazla bilgi için Google Haritalar Platformu faturalandırmasını anlama kılavuzumuza göz atın.

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

Konsolda kullanılabilecek başka para birimleri de bulunmaktadır. Farklı bir para birimi seçerseniz Fiyatlandırma E-Tablomuz'da ABD doları olarak listelenen fiyatlar ilgili para birimine dönüştürülür.

Faturalandırma ayarlarını yaptım. Faturamı nasıl görebilirim?

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

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ını ve maksimum günlük faturalandırılabilir sınırları belirlemenin yollarını sunar. Beklenmedik artışlardan kaçınmak için günlük maksimum sınırı belirleyebilirsiniz. Faturalandırma hesabındaki ödemeler belirlediğiniz bir 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 sınırı sınırlama:

Büyük bir faturadan kaçınmak için kullanımda günlük bir sınır belirleyerek beklenmedik artışlara karşı önlem alabilirsiniz. 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çip Kotalar sekmesini tıklayın.
"Günde istek sayısı" kotasının yanındaki düzenle simgesini tıklayın.

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

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

Faturalandırma hesabındaki ö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 ödemeler 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 "kullandıkça öde" türündeki yeni fiyatlandırma planımıza geçişine yardımcı olma amacıyla oluşturulmuştur. Bu geçiş hesabı sayesinde Google, bu müşterilere tek seferlik bir kredi verir ve müşteriler 200 ABD doları değerindeki bu ücretsiz katman kredisiyle Google Haritalar Platformu'nu kullanmaya devam edebilir. Bu sınır aşıldığında faturalandırma hesabı kapatılır ve hizmete erişimi kaybedersiniz. Hizmet kesintisinden kaçınmak için 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:

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.

Kota sınırım neden günde 1 istek olarak ayarlandı? Bu sınırı nasıl yükseltebilirim?

Projenize faturalandırma hesabı oluşturmadıysanız ve eklemediyseniz Haritalar Platformu API'leriniz günde 1 istekle sınırlandırılır. Faturalandırma hesabı oluşturup bağlayarak daha yüksek kota elde edebilirsiniz. Bunu yapmak için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.

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

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

Bu bildirim, Google'ın hesabınızda birden fazla faturalandırma hesabı kullanıldığını tespit etmesi nedeniyle gönderilmiştir. Bu durum, Google Haritalar Platformu Hizmet Şartları'nın 3.2.4 numaralı bölümünde tanımlanan Google şartlarını ihlal etmektedir. Bu şartlar uyarınca birden fazla faturalandırma hesabı oluşturmak yasaktır. Daha fazla bilgi için Faturalandırma Hesabı İhlali ile İlgili SSS başlıklı makaleyi 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 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 aracılığıyla kullanılabilir.

API Anahtarı:

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

Dijital İmza:

Google tarafından size sağlanan bir URL imzalama gizlisi kullanılarak dijital imza 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ğiyle ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.
API anahtarına uygulama kısıtlaması ekleyebilirsiniz. Kısıtlanan bir anahtar yalnızca bu tür kısıtlamaları destekleyen platformlarda çalışır. Dört tür uygulama kısıtlaması vardır. Aynı kısıtlama türünü uygulayan API'ler aynı kısıtlanmış anahtarı kullanabilir.
- IP adresleri (tekil sunucular): Web hizmeti API'leriyle birlikte kullanılır.
- HTTP yönlendirenleri (web siteleri): Web API'leriyle birlikte kullanılır.
- Android uygulaması kısıtlaması (paket adına ve parmak izine göre) - Android için Haritalar SDK'sı ile kullanım için.
- iOS uygulama kısıtlaması (iOS paket tanımlayıcısı bazında) - iOS için Haritalar SDK'sı ile birlikte 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 başlıklı makaleyi inceleyin.

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

API/SDK	Kimlik Bilgisi ve Uygulama Kısıtlaması
Android için Haritalar SDK'sı	Android kısıtlaması olan API anahtarı¹
Android için Yerler SDK'sı	Android kısıtlaması olan API anahtarı¹
Android için Navigasyon 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ı¹
iOS için Navigasyon SDK'sı	iOS kısıtlaması olan API anahtarı¹
Maps JavaScript API	HTTP yönlendirici kısıtlaması olan API anahtarı¹
Map Tiles API	IP adresi kısıtlaması olan API anahtarı¹
Maps Datasets API	OAuth jetonu
Aerial View API	IP adresi kısıtlaması olan API anahtarı¹
Maps Static API	HTTP yönlendiren kısıtlaması olan API anahtarı¹ + Dijital İmza²
Street View Static API	HTTP yönlendiren kısıtlaması olan API anahtarı¹ + Dijital İmza²
Maps Embed API	HTTP yönlendirici kısıtlaması olan API anahtarı¹
Address Validation API	IP adresi kısıtlaması olan API anahtarı¹
Directions API	IP adresi kısıtlaması olan API anahtarı¹
Distance Matrix API	IP adresi kısıtlaması olan API anahtarı¹
Elevation API	IP adresi kısıtlaması olan API anahtarı¹
Geocoding API	IP adresi kısıtlaması olan API anahtarı¹
Geolocation API	IP adresi kısıtlaması olan API anahtarı¹
Places API	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ı¹
Time Zone API	IP adresi kısıtlaması olan API anahtarı¹
Air Quality API	IP adresi kısıtlaması olan API anahtarı¹
Pollen API	IP adresi kısıtlaması olan API anahtarı¹
Solar API	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, 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ünü HTTP yönlendireninden 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 "Bu API ile kullanıldığında API anahtarlarında yönlendiren kısıtlamaları olamaz." hata mesajıyla başarısız olur. IP adresi kısıtlamaları olan bir API anahtarı kullanmaya geçmeniz gerekir.

API anahtarı kısıtlama türünü HTTP yönlendireninden 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ıtlamayı içeren 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önlendiren kısıtlaması olan bir API anahtarını IP adresi kısıtlamasına geçirmek için şunları 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ının 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.)"ni seçin ve uygun sunucu IP adreslerini girin, ardından Kaydet'i tıklayın.

Yeni bir API anahtarı nasıl alabilirim?

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

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

Haritalar API'lerinin çoğuyla ilgili sürüm değişikliği bilgilerini aşağıdaki bağlantılarda bulabilirsiniz:

Belirli bir hatanın hangi Google Haritalar Platformu sürümünde kullanıma sunulduğu ve düzeltildiğine dair bilgileri şu adresteki Google Haritalar Platformu Sorun Takip Aracı'ndan da kontrol edebilirsiniz:

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

API'yi sayfa yüklendikten sonra sayfaya nasıl asenkron olarak yükleyebilirim?

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

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

API, varsayılan olarak kullanıcının konumuna veya tarayıcı ayarlarına göre en uygun dili yüklemeye çalışır. Bazı API'ler, istek gönderirken açıkça bir dil belirlemenize olanak tanır. Dili ayarlama 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ş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	Azerice	ky	Kırgızca
eu	Baskça	lo	Laoca
be	Belarusça	lv	Letonca
bn	Bengalce	lt	Litvanca
bs	Bosna	mk	Makedonca
bg	Bulgarca	ms	Malayca
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)	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	Telugu dili
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
is	İ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 Hizmeti API'lerine güvenli (HTTPS) bağlantılar üzerinden erişilebilir. API'ye SSL üzerinden 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. Bu durumda varsayılan simge gösterilir.

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

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

Bir özellik talep etmek istiyorsanız lütfen öncelikle ilgili forumda bu isteği belirtin. Böylece, ihtiyaçlarınıza uygun bir çözümün henüz mevcut olmadığını doğrulayabilirsiniz.

Yeni bir hata tespit ettiğinizi veya gereksinimlerinizin Google Haritalar Platformu ürünlerinin mevcut işlevleriyle karşılanamadığını onayladıktan sonra lütfen Google Haritalar Platformu Sorun Takip Aracı'nı kullanarak hatanızı veya özellik isteğinizi bildirin.

Sorun Takip Aracı'na hata veya özellik isteği eklemeden önce lütfen ilgili hatanın ya da özelliğin daha önce eklenmediğinden emin olun. İlgilendiğiniz bir sorun varsa yıldız işareti ekleyerek ilgilendiğinizi belirtebilir ve güncellemelerden haberdar olabilirsiniz.

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ın önlenmesi gibi işlemler için Google'ın Gizlilik Politikası'na tabi çerezleri kullanır. Bu çerezler, oturum açılmış 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ılara yönelik ortaklaşa düzenlenmiş bir soru-yanıt sitesi olan Stack Overflow'da yer alır. Google Haritalar uygulamalarını geliştirme ve sürdürme hakkında teknik sorular sormak için mükemmel bir yerdir. Stack Overflow'da soru sorma hakkında daha fazla bilgiyi Destek sayfasında bulabilirsiniz.

En iyi sonuçlar için yardım isteğinde bulunurken lütfen aşağıdakileri göz önünde bulundurun:

Mevcut tartışmalarda arama yapma Benzer bir sorun yaşayan ve çözüm bulan başka bir kullanıcı
Mümkünse sitenizin bağlantısını gönderin. Kod yalnızca internette kolayca görüntülenemiyorsa kod snippet'lerini yayınlayın.
Tarayıcı sürümleri, hatalar ve bu sorunu gidermede faydalı olabilecek diğer tüm bilgiler dahil olmak üzere ilgili tüm bilgileri sağlayın.

Hatalar ve sorun giderme

Bu hatanın anlamı nedir?

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

Haritalarım normalden daha koyu görünüyor. Neler oluyor?

Belirli durumlarda, "sadece geliştirme amaçları için" metniyle filigranlanmış karartılmış bir harita veya "negatif" bir Street View görüntüsü gösterilebilir. Bu davranış genellikle API anahtarıyla veya faturalandırmayla ilgili sorunları gösterir. Google Haritalar Platformu ürünlerini kullanmak için faturalandırma hesabınızın olması ve tüm isteklerin geçerli bir API anahtarı içermesi gerekir. Aşağıdaki akış, bu sorunu gidermenize yardımcı olacaktır:

API anahtarı kullanıyor musunuz?

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

Maps JavaScript API'yi yüklemek için kullanılan URL'de key parametresi olarak bir API anahtarı iletilir. API anahtarı kullanıp kullanmadığınızı kontrol etmek için birkaç seçenek vardır:

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

Google Maps JavaScript API uyarısı: NoApiKeys
Google Haritalar JavaScript API 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 aşağıdaki koddaki YOUR_API_KEY yerine API anahtarınızı koyun.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Web siteniz tarafından oluşturulan ağ trafiğini tarayıcıda kontrol edin. Chrome'da bu bilgi, DevTools 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 olur. Burada, isteklerin key parametresini kullanıp kullanmadığını onaylayabilirsiniz. Ağ sekmesini görüntülerken maps/api/js'ye göre ağ trafiğinizi filtrelemeniz faydalı 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 talimatları eksiksiz olarak uygulayın.
Başlayın

Evet, API anahtarı kullanıyorum.

Mükemmel! Şimdi projenize faturalandırma hesabı eklenip eklenmediğini kontrol edelim.

Projenize faturalandırma hesabı eklenmiş mi?

Emin değilim. Faturalandırma hesabının projeme eklenip eklenmediğini 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:

Sol taraftaki Google Haritalar Platformu > Kimlik Bilgileri bölümünden Kimlik Bilgileri'ne gidin.
Web sitenizde şu anda kullandığınız API anahtarının listelenip listelenmediğini kontrol edin. Aksi takdirde farklı bir projeye geçip oradaki kimlik bilgilerini kontrol edin.
API anahtarınızın projesini bulamıyorsanız bu projeye erişimi kaybetmiş olabilirsiniz. Kuruluşunuzdaki diğer kişilerden yardım isteyin. Orijinal proje bulunamazsa:
1. Yeni bir proje oluşturun. Proje listesinden Yeni Proje'yi seçerek veya Kaynak Yöneticisi sayfasından Proje Oluştur'u seçerek bu işlemi yapabilirsiniz.
2. Yeni bir API anahtarı oluşturma. Bu işlemi Kimlik Bilgileri sayfasından yapabilirsiniz. Bu sayfaya geldiğinizde Kimlik bilgileri oluştur'u tıklayın ve ardından API anahtarı'nı seçin.

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

Hayır, projeme faturalandırma hesabı eklenmedi.

Cloud Console'da Faturalandırmayı etkinleştir sayfasına gidin ve projenize faturalandırma hesabı ekleyin. Daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.

Evet, projeme faturalandırma hesabı eklendi.

Mükemmel! 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 (ör. süresi dolmuş bir kredi kartı)?

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

API'de kendiniz belirlediğiniz günlük sınırı aştıysanız

API'lerinizden herhangi biri için günlük sınır belirlediyseniz (beklenmedik artışları önlemek için yaygın olarak yapılan bir işlemdir) bu sorunu günlük sınırınızı artırarak çözebilirsiniz.

Günlük sınırlarınızı Cloud Console'daki API'ler ve Hizmetler Kontrol Paneli'ne giderek kontrol edebilirsiniz. Bu bölümde:

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

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

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

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

Bu hata kodları aşağıdakilerden biri nedeniyle döndürülebilir:

İstekte API anahtarı eksik.
Sağlanan API anahtarı geçersiz.
Projeye faturalandırma hesabı eklenmemiş.
Kendi belirlediğiniz kullanım sınırı aşıldı.
Sağlanan ödeme yöntemi artık geçerli değilse (ör. kredi kartının süresi dolmuşsa).
Belirli bir API için kota 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 düzeltmek için aşağıdaki adımları uygulayın:

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

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

kGMSPlacesRateLimitExceeded veya 9005 PLACES_API_RATE_LIMIT_EXCEEDED 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 adresini ziyaret edin.

"Bu IP, site veya mobil uygulamanın bu API anahtarını kullanma yetkisi yok." 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ştirdiyseniz ve yetkisiz bir IP adresi istek göndermeye çalışıyorsa
API anahtarınızda HTTP yönlendiren (web sitesi) kısıtlamalarını etkinleştirdiyseniz ve yetkisiz bir yönlendiren istek göndermeye çalışıyorsa
Paket adı ve parmak izi ayarlayarak Android uygulamalarınızın kullanımını kısıtladınız ve yetkisiz bir Android uygulaması istek göndermeye ç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.
HTTP yönlendiren kısıtlamaları olan bir API anahtarıyla web hizmeti API'lerinden herhangi birini kullanıyorsanız bu hatayı alabilirsiniz. Bu API'lere yapılan istekler, IP adresi kısıtlamalarına sahip bir API anahtarıyla tanımlanmalıdır. Anahtar kısıtlama türünüzü HTTP yönlendireni 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ı başlıklı makaleyi inceleyin.

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 şunları yapın:

Cloud Console'un Kimlik bilgileri sayfasına gidin.
İncelemek istediğiniz API anahtarını içeren projeyi seçin.
Anahtar için belirlenen 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.
Anahtar için ayarlanan tüm 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.

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

Bir HTTP yönlendireniyle kısıtlanmış bir API anahtarıyla web hizmeti API'lerinden herhangi birini kullanıyorsunuz. Web hizmeti API'lerinin güvenlik nedeniyle IP adresleriyle sınırlı API anahtarları kullanması gerekir. Anahtar kısıtlamanızın türünü HTTP yönlendireni 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ş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 verebilecek bir REST arayüzü sunan Coğrafi Kodlama API'sini de sağlar.

Coğrafi kodlama hangi ülkelerde kullanılabilir?

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

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

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

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

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

Coğrafi kodlayıcı, sokak adreslerini coğrafi koordinatlarla eşlemek için tasarlanmıştır. Bu nedenle, başarılı bir sorgu olasılığını en üst düzeye çıkarmak için coğrafi kodlayıcı isteklerini aşağıdaki yönergelere uygun şekilde biçimlendirmenizi öneririz:

Adresleri, ilgili ülkenin ulusal posta hizmeti tarafından kullanılan biçime uygun şekilde belirtin.
İlgili ülkenin posta hizmeti tarafından tanımlanan adrese dahil edilmeyen işletme adları, birim numaraları, kat numaraları veya daire numaraları gibi ek adres öğeleri belirtmeyin. Aksi takdirde, ZERO_RESULTS içeren yanıtlar alabilirsiniz.
Artı kodlarını burada gösterildiği gibi biçimlendirin (artı işaretleri URL'de %2B olarak, boşluklar ise %20 olarak kodlanır):
- Küresel kod, 4 karakterli bir alan kodu ve 6 karakter veya daha uzun bir yerel koddur (849VCWC8+R9, 849VCWC8%2BR9'dir).
- Karma kod, açık bir konuma sahip 6 karakter veya daha uzun bir yerel koddur (CWC8+R9 Mountain View, CA, ABD için CWC8%2BR9%20Mountain%20View%20CA%20USA).
Mümkünse binanın adı yerine tesisin sokak numarasını kullanın.
Mümkün olduğunda kesiştiği sokakları belirtmek yerine sokak numarası adreslerini kullanın.
Yakındaki önemli yerler gibi "ipuçları" vermeyin.

Coğrafi kodlama için numaralı bir ABD karayolundaki adresi nasıl biçimlendirmeliyim?

Google Haritalar Platformu coğrafi kodlayıcısı, ABD'deki numaralı otoyolların adreslerde aşağıdaki şekilde belirtilmesini zorunlu kılar:

Bölge Yolları: "Co Road NNN" burada NNN yol numarasıdır. Ör. "Co Road 82"
Eyalet Karayolları: "State NNN" Burada Eyalet, eyaletin tam adıdır ve NNN, karayolu numarasıdır. Ör. "California 82"
ABD otoyolları: "U.S. NNN" Burada NNN otoyol numarasıdır. ör. "U.S. 101"
ABD eyaletler arası otoyolları: "Interstate NNN" (NNN eyaletler arası otoyol numarasıdır. ör. "Interstate 280"

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

Farklı coğrafi kodlama stratejilerinin avantaj ve dezavantajlarını ayrıntılı olarak açıklayan Coğrafi Kodlama Stratejileri belgesine bakın.

Google Haritalar Platformu ile sürüş yol tariflerini nasıl sağlayabilirim?

Routes API'nin Rota Hesaplama Hizmeti ve Directions API, tek ve çok aşamalı yolculuklar için sürüş yol tarifleri sağlamanıza olanak tanır. Yönlendirme seçenekleri, bir seyahat modu (araba), tek bir rota veya rota grubu ve kısıtlamalar (paralı yollar yok) ile yol tariflerini şekillendirmenize yardımcı olur. Bu hizmetler aşağıdaki biçimlerde sunulur:

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 sürüş yönergeleri 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ümanda ek örnekler verilmiştir.
Sunucu tarafı uygulamalar için Java, Python, Go ve Node.js istemci arayüzleri aynı işlevi sağlar. İstemci kitaplıkları hakkında daha fazla bilgi edinmek için Directions API istemci kitaplıkları başlıklı makaleyi inceleyin.

Araçla yol tarifi hangi ülkelerde kullanılabilir?

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

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

Directions API ve Distance Matrix API, Japonya'dakiler hariç tüm Google toplu taşıma iş ortaklarını destekler.

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

Maps JavaScript API'deki KmlLayer sınıfı, geliştiricilerin KML/KMZ ve GeoRSS dosyalarını haritanın üzerine yerleştirmesini sağlar. Dokümanları ve örnekleri burada bulabilirsiniz.

Maps JavaScript API'nin KmlLayer sınıfı kullanılarak görüntülenebilen 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.

İntranet sitelerinde barındırılan KML dosyalarını haritada nasıl oluşturabilirim?

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

İntranet sitelerinde barındırılan KML dosyalarını kullanan uygulamalar geliştirmeniz gerekiyorsa üçü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, KmlLayer sınıfını kullanmaktan daha düşük performans elde edilebilir.

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ıyla ilgili herhangi bir sınırlama yoktur. Özel simgeler kullanırken istek başına beş adede kadar benzersiz simge belirtilebilir ancak her biri haritada birden çok kez kullanılabilir.

Haritalar Statik API URL'lerinin en fazla yaklaşık 8.192 karakter içerebileceğini unutmayın. Bu,her bir enlem/boylam çifti belirtilirken kullanılan ondalık sayı basamak sayısına göre belirtilebilecek işaretçi ve yol köşesi sayısını kısıtlar. Kullanılan ondalık sayı basamaklarının sayısı ile Dünya'daki doğruluk arasındaki ilişki hakkında bilgi edinmek için ondalık dereceler ile ilgili Wikipedia makalesine bakın.

Belirli ülkelerdeki Google Haritalar Platformu ürünlerine neden erişemiyorum?

Maps API'ler Yasaklanmış Bölgeler'de kullanılamaz. Hizmet Şartları'nı da inceleyin.

Google ana haritasındaki sorunları 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ış bilgi
Yanlış çizilmiş yol
Kapalı yollar
Var olmayan yollar

Bir yer 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ı kısıtlı olan istekler için düzeltilmesi gerekenlerle ilgili ayrıntıları içeren bir destek kaydı oluşturun.

Maps JavaScript API ile kullanılan hizmetlerin performansı nasıl izlenir?

Bazı istemci tarafı özellikler, SLO'yu (Hizmet Düzeyi Hedefi) hesaplamak amacıyla başarı veya başarısızlığı bildirmek için donatılmıştır. Bu bilgiler, hizmet düzeyi hedefi bilgilerini günlüğe kaydeden aramalarda maps.googleapis.com/maps_api_js_slo/log noktasında Google'a gönderilir. Bu bilgiler arasında başarı durumu, gecikme süresi ve kullanılan Maps JavaScript API sürümü/kanalı yer alır. Aramalar performans için toplu olarak yapılabilir. Bu çağrıların tarayıcı düzeyinde engellenmediğinden emin olmak için İçerik Güvenliği Politikanızda maps.googleapis.com'e izin vermeniz gerekebileceğini lütfen unutmayın. Örneğin: HTTP üst bilgileriyle Content-Security-Policy: default-src 'self' maps.googleapis.com; veya HTML meta etiketleriyle <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;">.

Maps JavaScript API

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

iOS için Google Haritalar SDK'sı

kGMSPlacesRateLimitExceeded hatasını nasıl çözebilirim?

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ıldı ve artık kullanılamıyor. Lütfen uygulamanızı en kısa sürede en son sürüme güncelleyin. Ayrıntılar için taşıma kılavuzuna bakın.

iOS 8.x cihazda hata ayıklama yaparken kilitlenmeler yaşıyorum. Ne yapmalıyım?

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 aşağıdaki adımları uygulayın:

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

Genel iOS cihaz sayfasındaki Xcode GPU Frame Capture (Xcode GPU Kare Yakalama) seçeneği

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

iPhone X'ten itibaren iPhone'larda yuvarlatılmış köşeler, cihazın sensör muhafazası için üstte bir çentik ve ana ekrana erişmek için ekranın alt kısmında bir gösterge bulunur. Apple, iOS 11.0 SDK'dan itibaren geliştiricilerin öğeleri yeni ekran şekli tarafından kırpılmadan güvenli bir alanda konumlandırmasına olanak tanıyan Safe Area API'yi ekledi.

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

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

Varsayılan olarak, dolgularınızı her zaman ekleriz. Google Haritalar iOS SDK'sı, dolgunun güvenli alan içinden doldurulmasını amaçladığını varsayar. Arayüzünüzü her şeyin güvenli alanda konumlandırılacağı varsayımıyla tasarlarsanız bu işlem ek çaba gerektirmeden çalışır.

Varsayılan ayarlarımızla çalışmayan bir arayüz tasarladıysanız GMSMapView'e paddingAdjustmentBehavior adlı yeni bir özellik ekledik. GMSMapView artık üç dolgu ayarlama davranışından birini seçmenize olanak tanır: "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 iç içe eklemeleri ekler. Bu sayede, tüm yerleşimlerin güvenli alanın kenarlarından yapılacağı varsayımıyla arayüzünüzü tasarlayabilirsiniz. Bu, varsayılan değerdir.

GMSMapView, "Otomatik" dolgu davranışını kullanacak şekilde ayarlanmışsa her zaman dolgu veya güvenli alan içe ekleme arasından daha büyük olanı seçer. Bu sayede, tüm öğelerin güvenli alanda kalmasını sağlayarak ekran kenarından dolgu ekleyebilirsiniz.

GMSMapView, "Hiçbir zaman" dolgu davranışını kullanacak şekilde ayarlanırsa güvenli alan iç içe eklemelerini hiçbir zaman dolguya eklemez. Bu, 2.5 sürümünden önceki davranıştır ve dolgu alanınız güvenli alanı zaten dikkate alıyorsa veya diğer davranışlarımız arayüzünüzle iyi çalışmıyorsa 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'ın 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 çözebilirim?: 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ü devre dışı bırakıldı ve artık kullanılamıyor. Lütfen uygulamanızı en kısa sürede en son sürüme güncelleyin. Ayrıntılar için taşıma kılavuzuna bakın.

Uygulamamda harita yerine yalnızca boş gri karolar gösteriliyor. Bu sorunu nasıl çözebilirim?

Harita yerine boş gri karoların gösterilmesinin yaygın nedenlerinden biri kimlik doğrulama sorunlarıdır. adb logcat'i 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ı bir cihaza veya Android emülatörüne yükleyin. Android emülatör kullanıyorsanız emülatör ayarlarında Play Store'un bulunduğundan emin olun.
Android Studio terminalinde adb logcat -e "Google Maps Android API" komutunu çalıştırın. Bu komut yalnızca günlük mesajının "Google Haritalar Android API" ile eşleştiği satırları yazdırır. (İsteğe bağlı olarak, > logcat.txt ekleyerek günlüğü bir metin dosyasına aktarabilirsiniz.)
Sorunu cihazınızda yeniden oluşturun ve aşağıdakiler gibi sık karşılaşılan hataları kontrol edin:

Manifest dosyasında yanlış/istenmeyen bir API anahtarına referans veriliyor.
Projede faturalandırma etkin değil.
SDK, proje API'lerinde etkinleştirilmemiş.
API anahtarı kısıtlamalarına yanlış SHA1 parmak izi eklenmiş.
build.gradle dosyasına Google Play Hizmetleri bağımlılıkları dahil edilmemiştir.

URL imzalama

JavaScript kullanarak URL'leri imzalayabilir miyim?

URL'leri JavaScript kullanarak imzalamak, URL imzalama gizliliğinizi son kullanıcılara ifşa edeceğinden bunu yapmamanızı önemle tavsiye ederiz. Bu nedenle imzalar yalnızca sunucu tarafı bileşenler tarafından oluşturulmalıdır.

Maps API web hizmeti isteklerine neden HTTP 403 Yasak yanıtı alıyorum?

HTTP 403 yanıtı, büyük olasılıkla bu istek için imzanın doğrulanamaması nedeniyle izin sorunu olduğunu gösterir. Bunun nedeni aşağıdakilerden biri olabilir:

Bir imza belirtilmiş ancak bu istek için yanlış.
İstek, Google Haritalar Platformu Premium Plan API anahtarını belirtiyor ancak imza belirtmiyor. Ç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ş.