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ştirmelerine veya Google Haritalar'dan veri almalarına olanak tanıyan bir API ve SDK grubudur. Birkaç farklı seçenek vardır. İhtiyaçlarınıza bağlı olarak, aşağıdaki API'ler ve SDK'lardan birini veya bunların bir kombinasyonunu kullandığınızı bulabilirsiniz:

Haritalar:

Güzergahlar:

Yerler:

Ortam:

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

Google Haritalar Platformu'nu Kullanmaya Başlama bölümüne bakın.

Hangi API'ye ihtiyacım var?

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

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

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

Google Haritalar Platformu hangi ülkeleri kapsıyor?

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

Ayrıca bkz.:

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

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

Evet. Google Haritalar artık, hiçbir programlamaya veya Google Haritalar Platformu'nu kullanmaya gerek kalmadan, görüntülediğiniz haritayı web sitenize veya blogunuza yerleştirme olanağı sunuyor. Daha fazla bilgiyi burada bulabilirsiniz.

Mobil cihazlarda Haritalar uygulamalarını nasıl dağıtabilirim?

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

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

Maps JavaScript API, mobil cihazlara uyum sağlamak için geliştirilmiştir ve hem masaüstü hem de tam JavaScript uygulamasına sahip Apple iPhone gibi bir web tarayıcısına sahip cihazları hedefleyen tarayıcı uygulamaları için uygundur.

Haritalar Statik API, Maps JavaScript API'yi kullanmaya uygun olmayan cihazları hedefleyen uygulamalar için GIF, JPG ve PNG biçimlerinde, işaretçiler ve çoklu çizgiler de dahil olmak üzere harita görüntüleri sunar. Maps Static API'yi tarayıcı tabanlı uygulamalar dışında kullanmak için harita görüntüsünün Google Haritalar'a bağlı olması gerektiğini unutmayın.

Maps JavaScript API ve Maps Embed API hangi web tarayıcıları tarafından desteklenir?

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

Masaüstü

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

Android

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

iOS

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

Haritaları Maps JavaScript API'den yazdırabilir miyim?

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

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

Google'ın çeşitli geliştirici teklifleriyle ilgili haberler için Google Haritalar Platformu Blogu'na abone olmanız gerekir.

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

Mevcut destek seçenekleri hakkında bilgi edinmek için Google Haritalar Platformu Desteği ve Kaynakları bölümüne bakın.

Teknik destek ne zaman sunulur?

Destek ekibi, "hizmetin kullanılamadığı durumlar" ile ilgili bölgesel tatiller hariç olmak üzere, hafta içinde Pasifik Saati ile Pazartesi 09:00'dan Cuma 17:00'ye kadar) 5 gün 24 saat hizmet verir.

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

Google Hesabınıza erişimi kaybettiyseniz (ör. ali@sirketim.com veya ali@gmail.com) şifrenizi geri alarak veya sıfırlayarak hesap erişimini geri yüklemeyi deneyebilirsiniz. Google Hesabı Yardımı'nda 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ı silme işlemini geri almasını isteyin.

Belirli bir projeye erişimi nasıl kurtarabilirim?

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

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

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

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

Google Hesabınıza erişimi kaybettiyseniz: Hesabınızın kullanıcı adınızı veya şifrenizi kurtarmayı deneyin.
Google Hesabınıza erişimi kurtaramazsanız: Yeni bir Google Hesabı oluşturun, daha sonra mevcut proje sahiplerinden biriyle iletişime geçerek yeni Google Hesabınızı projeye eklemesini isteyin.

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

Yeni Arm tabanlı Mac'lerde geliştirilmesi mümkün olsa da, uygulama geliştirmenin fiziksel bir iOS cihazda yapılmasını gerektirir. Simülatörler üzerinde geliştirme yapmak 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ı'na şu adresten ulaşabilirsiniz:

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.

Bununla birlikte, Google Haritalar Platformu'nun görmek istemediğimiz bazı kullanımları da var: Örneğin, bir şehirde yasa dışı uyuşturucu satın alınacak yerleri belirten haritalar veya diğer yasa dışı etkinlikler. Ayrıca kişilerin gizliliğine de saygı gösteriyoruz. Bu nedenle, Google Haritalar Platformu, kişiler hakkındaki gizli bilgileri tanımlamak için kullanılmamalıdır.

Uygulamanızı geliştirip kullanıma sunmadan önce, uygulamanızın Google Haritalar Platformu Hizmet Şartları'na uygun olup olmadığını belirlemek için kendi danışmanınızdan yardım almanız gerekir. Google mühendisleri yalnızca teknik destek sunabilir ve hukuki tavsiye vermek için gerekli niteliklere sahip değildir. Google, hizmet kullanımınızı istediği zaman askıya alma veya sonlandırma hakkını saklı tutar. Bu nedenle, Haritalar API'leri Şartları'nı dikkatli bir şekilde okuyun.

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

Google Haritalar Platformu dışında herhangi bir mekanizma aracılığıyla harita parçalarına veya uydu görüntülerine erişemezsiniz (örneğin, kendi harita API'nizi oluşturmak veya bir toplu karo indirme komut dosyasını kullanmak). Uygulamanızın bu kartlara Google Haritalar Platformu dışından erişirse erişimi engellenir. Daha fazla bilgi için Google Haritalar Platformu Hizmet Şartları'na göz atın.

Google Haritalar Platformu ürünlerini uygulamaları izlemek 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 artık Google Haritalar Platformu Hizmet Şartları'nın diğer kısıtlamalarına uymaları koşuluyla web harici uygulamalarda kullanılabilir.

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

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

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

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 dokümana resimler de 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 "Toplama Yok" bölümüne bakın.

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

Artık bu verileri toplamıyoruz. indexing parametresinin kullanımı kullanımdan kaldırılmıştır ve herhangi bir etkisi yoktur. Artık bu özelliği açıkça devre dışı bırakmanız gerekmiyor. Ancak en kısa sürede bu parametreyi kaldırmanızı öneririz.

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

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

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

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

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

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

Google Cloud Platform Ücretsiz Katman müşterileri ücretli hesaba nasıl geçiş yapar?

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

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

Google Haritalar Platformu ürünlerine gönderebileceğiniz istek sayısıyla ilgili maksimum günlük sınır yoktur ve yalnızca saniyedeki maksimum sorgu (QPS) veya dakikadaki sorgu sayısı (QPM) ile ilgilidir.

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

Routes:Compute Rota Matrisi için sınır, dakikadaki öğe sayısı (EPM) cinsinden belirtilir. Burada bir istekteki öğe sayısı şuna eşittir: (kaynak sayısı × hedef sayısı).

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

API	Kullanım sınırı
Adres Doğrulama	6.000 QPM
Havadan Görünüm: Video Ara	180 QPM ve 100.000 QPD
Havadan Görünüm: Videoyu Oluştur	100 QPM ve 100 QPD
Hava Kalitesi	6.000 QPM
Yol tarifi	3.000 QPM
Mesafe Matrisi	60.000 EPM
Dinamik Haritalar	30.000 QPM
Rakım	6.000 QPM
Coğrafi Kodlama	3.000 QPM
Coğrafi konum	6.000 QPM
Map Tiles API: 2D Parçalar ve Street View Karoları	6.000 QPM ve 15.000 QPD
Harita Tiles API'sı: Fotogerçekçi 3D Parçalar	10.000 QPD
Harita Tiles API'sı: Fotogerçekçi 3D Parçalar: Oluşturucu	12.000 QPM
Yerler	6.000 QPM
Polen	6.000 QPM
yollar	30.000 QPM
Rotalar: İşlem Rotaları	3.000 QPM
Rotalar: İşlem Rotası Matrisi	3.000 EPM
Güneş enerjisi	Dakikada 600 Sorgu (QPM)
Statik Haritalar	30.000 QPM
Street View Image API	30.000 QPM
Saat Dilimi	30.000 QPM

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 Tablosu'na bakın.

Google Haritalar Platformu API'lerinin nasıl faturalandırıldığı hakkında daha fazla bilgi edinmek için lütfen Haritalar, Rotalar, Yerler ve Çevre 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 için ücretlendirilirsiniz:

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

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

Street View Static API'ye statik (etkileşimsiz) bir Street View panoraması yerleştirmek amacıyla gönderilen her istek için statik bir Street View panoraması ücretlendirilir.
Maps JavaScript API'de, Android için Haritalar SDK'sında veya iOS uygulaması için Haritalar SDK'sında bir panorama nesnesinin her örneklendirmesi için dinamik Street View panoraması üzerinden ücret alınır.

Bir web sayfası veya uygulama bir haritayı ya da statik bir harita resmini veya Street View panoramasını yükledikten sonra, kaydırma, yakınlaştırma ya da harita katmanları arasında geçiş yapma gibi kullanıcı etkileşimleri, ek harita yüklemeleri oluşturmaz veya kullanım sınırlarını etkilemez.

İşaretçi eklemek ek harita yüklemeleri oluşturmaz ancak raptiye konumunun belirlenme şekline bağlı olarak ücretlendirme uygulayabilir (örneğin "google.maps.Map()" sınıfını yüklemek veya yeniden yüklemek gibi).

Kullanımımı nasıl izlerim?

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

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

Projenin tamamına ait 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ızla ilgili raporları görüntülemek için sağ kenar çubuğundaki filtreleri kullanın.

Daha fazla bilgi için Google Haritalar Platformu Raporlaması ile API Kullanımınızı İzleme ve API Kullanımını Sınırlama sayfalarını inceleyin.

İ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 durumunda API'ye erişiminiz geçici olarak engellenebilir.

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ünün, Maps JavaScript API'de kullanılabilen eşdeğer bir istemci tarafı hizmeti vardır: Yol Tarifi, Mesafe Matrisi, Yükseklik ve Coğrafi Kodlama.

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

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

Bu, tekrar daha fazla kullanıma izin verilene kadar web hizmetinin normal yanıt vermeyi durduracağı ve yalnızca OVER_QUERY_LIMIT durum kodunu döndürmeye geçeceği anlamına gelir. Uygulamanızın saniyede çok fazla istek göndermesi nedeniyle hata alındıysa bu işlem 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 Rehberi'ne bakın.

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

Evet. Bununla birlikte, uygulamanızın dayandığı herhangi bir Google Haritalar Platformu'nun kullanım sınırları hakkında bilgi edinmenizi öneririz.

Web sitem veya uygulamam bir anda popülerleşirse haritalarım çalışmayı durdurur mu?

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

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

Kullanım her günün sonunda hesaplanır ve Fiyatlandırma Tablosunda gösterildiği gibi fiyatlandırılır. Her ayın sonunda toplam kullanım için faturalandırma hesabınızla ilişkili ödeme yöntemi kullanılır. Daha fazla bilgi için Google Haritalar Platformu Faturalandırması'nı inceleyin.

Google Haritalar Platformu'nu kullanmanın maliyeti nedir?

API başına maliyete genel bakış için Fiyatlandırma Tablosu'na göz atın. Uygulamanız aylık 200 ABD dolarına kadar istekler veya harita yükü hacimleri oluşturursa kullanımınız için ücret alınmaz. Aylık 200 ABD doları krediyi aşan kullanımlar için faturalandırma hesabınız üzerinden ücret alınır. Daha fazla bilgi için Google Haritalar Platformu faturalandırmasını anlama kılavuzumuzu inceleyin.

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

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

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

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

Ek kaynaklar:

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

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

Google Haritalar Platformu, günlük istek sınırları ve maksimum günlük faturalandırılabilir sınırlar belirleme yöntemleri sunar. Beklenmedik artışlardan kaçınmak için maksimum günlük kullanım sınırını belirleyebilirsiniz. Ayrıca, faturalandırma hesabındaki ücretler 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:

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

API'ler ve Hizmetler Kontrol Paneli'ne gidin.
İstenirse proje seçin.
Listeden bir API seçip Kotalar sekmesini tıklayın.
"Günlük istek sayısı" kotasının yanındaki düzenleme 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 ücretler belirlediğiniz eşiğe ulaştığında faturalandırma yöneticilerine e-posta bildirimleri göndermek için bütçe uyarıları ayarlayın. Faturalandırma hesabındaki tahmini ücretler eşiğin %50, %90 ve% 100'ünü aştığında faturalandırma yöneticilerine e-posta bildirimleri gönderilir.

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

"Google Haritalar Platformu Geçiş Hesabı", belirli müşterilerin yeni kullandıkça öde fiyatlandırma planımıza geçiş yapmasına yardımcı olmak için oluşturuldu. Bu geçiş hesabı sayesinde Google, bu müşterilere tek seferlik bir kredi verdi. Böylece müşteriler Google Haritalar Platformu'nu 200 ABD doları değerindeki ücretsiz katman sınırına kadar kullanmaya devam edebilir. Bu sınır aşıldığında faturalandırma hesabı kapatılır ve hizmete erişimi kaybedersiniz. Hizmet kesintisi yaşamamak için kendi faturalandırma hesabınızı ayarlamanızı ve 200 ABD doları tutarındaki ücretsiz aylık katmanın keyfini çıkarmaya 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 yükseltebilirim?

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

Bir faturalandırma hesabı oluşturup eklemenizin ardından günlük kota sınırınız kaldırılır. Dilerseniz Cloud Console'da beklenmedik harcamaları önlemek için sınır belirleyebilirsiniz.

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

Bu bildirim, Google'ın, hesabınızın birden fazla faturalandırma hesabı kullandığını belirlediği için gönderilmiştir. Bu durum, Google Haritalar Platformu Hizmet Şartları'nın 3.2.4 bölümünde tanımlanan Google şartlarını ihlal etmektedir. Bu şartlar uyarınca, birden fazla faturalandırma hesabı oluşturmak yasaktır. Daha fazla bilgi için Faturalandırma Hesabı İhlaliyle İlgili SSS bölümüne bakın.

Google Haritalar Platformu'nu kullanma

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

Google Haritalar Platformu ürünlerini her kullandığınızda isteğinizi doğrulamak için bir API anahtarı eklemeniz gerekir. Google Haritalar Platformu; Android, iOS veya web uygulamaları 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.
Şu anahtarla API yükleme örneği: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Dijital İmza:

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

Kısıtlamalar:

API anahtarı kısıtlamaları isteğe bağlıdır ancak daha fazla güvenlik için tüm API anahtarlarını kısıtlamanızı önemle tavsiye ederiz. Daha fazla bilgi için API güvenliği en iyi uygulamalarına göz atın.
API anahtarına 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 (tek sunucular) - Web hizmeti API'leriyle kullanım içindir.
- HTTP yönlendirenler (web siteleri) - web API'leriyle kullanım içindir.
- Android uygulama kısıtlaması (paket adına ve parmak izine göre) Android için Haritalar SDK'sı ile kullanım içindir.
- iOS uygulama kısıtlaması (iOS paket tanımlayıcısına göre): iOS için Haritalar SDK'sı ile kullanım içindir.
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ünü inceleyin.

Aşağıdaki tabloda her bir Google Maps Platform API/SDK için anahtar/kimlik bilgisi ve uygulama kısıtlaması belirtilmiştir.

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ı¹
Map Tiles API	IP adresi kısıtlaması olan API anahtarı¹
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önlendiren kısıtlaması olan API anahtarı¹
Address Validation API (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ı¹
Geocoding API	IP adresi kısıtlaması olan API anahtarı¹
Coğrafi Konum API'si	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ı¹
Hava Kalitesi API'si	IP adresi kısıtlaması olan API anahtarı¹
Polen 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, Haritalar Static API ve Street View Static API için dijital imza gerekebilir. Kullanımdan bağımsız olarak isteklerinizin kimliğini doğrulamak için hem API anahtarı hem dijital imza kullanmanızı önemle tavsiye ederiz.

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

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

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

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

HTTP yönlendiren 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ındaki API anahtarları listesinden API anahtarının adını seçerek anahtarın ayrıntılarını düzenleyin.
Sayfanın Anahtar kısıtlaması bölümünde "IP adresleri (web sunucuları, cron işleri vb.)" seçeneğini belirleyin, uygun sunucu IP adreslerini girin ve Kaydet'i tıklayın.

Nasıl yeni bir API anahtarı alabilirim?

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

Google Haritalar API'lerinin her bir sürümünde kullanıma sunulan değişiklikleri nasıl bulabilirim?

Maps API'lerin birçoğu için sürüm değişikliği bilgilerini aşağıdaki bağlantılarda bulabilirsiniz:

Belirli bir hatanın Google Haritalar Platformu'nda hangi sürümünde ortaya çıktığını ve düzeltildiğini şu adresten kontrol edebilirsiniz: Google Haritalar Platformu Sorun İzleyicisi'ni kullanarak:

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

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

Bunun için API'yi yüklerken geri çağırma parametresini belirtmeniz yeterlidir. Daha fazla bilgi ve örnek koda Maps JavaScript API dokümanlarının Başlarken bölümünden ulaşabilirsiniz.

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

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

Desteklenen Diller:

Google, desteklenen dilleri sıklıkla 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ça	lo	Laoca
be	Belarus dili	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	Nepal Dili
zh-HK	Çince (Hong Kong)	no	Norveççe
zh-TW	Çince (Geleneksel)	pl	Lehçe
s	Hırvatça	pt	Portekizce
cs	Çekçe	pt-BR	Portekizce (Brezilya)
da	Danca	pt-PT	Portekizce (Portekiz)
nl	Felemenkçe	pa	Pencap Dili
en	İngilizce	ro	Rumence
en-AU	İngilizce (Avustralya)	ru	Rusça
en-GB	İngilizce (İngiltere)	sr	Sırpça
et	Estonca	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
:	İzlandaca	vi	Vietnamca
id	Endonezce	zu	Zulu
it	İtalyanca

Bu örnek uygulamada, yukarıda listelenen dillerin 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'ye güvenli (HTTPS) bağlantılar üzerinden erişilebilir. API'ye SSL üzerinden nasıl erişileceği hakkında bilgi için lütfen ilgili API'nin belgelerine bakın.

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

Google Haritalar Platformu'ndaki bir hatayı nasıl bildirebilir veya yeni bir özellik için nasıl istekte bulunabilirim?

Hata olabileceğini düşündüğünüz bir davranışla karşılaşırsanız lütfen öncelikle ilgili forumda bu durumu bildirin. Böylece diğer geliştiricilerin hatayı doğrulayabilir ve kodunuzla ilgili olası sorunları eleyebilirler.

Ayrıca, bir özellik isteğinde bulunmak isterseniz lütfen önce gereksinimlerinizi karşılayan bir çözümün bulunmadığını onaylamak için ilgili forumda bunu belirtin.

Yeni bir hata tespit ettiğinizi veya Google Haritalar Platformu ürünlerinin mevcut işlevleriyle gereksinimlerinizin karşılanmadığını doğruladıktan sonra lütfen hatanızı ya da özellik isteğinizi Google Haritalar Platformu Sorun İzleyici'yi kullanarak bildirin.

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

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

Android için Haritalar SDK'sı ve iOS için Haritalar SDK'sı, Google'ın Gizlilik Politikası'na tabi olan, 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 çerezleri kullanır. Bu çerezler, oturum açmış herhangi bir Google Hesabı ile ilişkilendirilmez ve API çağrılarından toplanan diğer bilgilerle günlüğe kaydedilmez.

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

Google'ın Geliştirici İlişkileri ekibi, programcılar için ortaklaşa düzenlenen bir soru ve cevap sitesi olan Stack Overflow'da varlık gösteriyor. Burası, Google Haritalar uygulamalarının geliştirilmesi ve sürdürülmesi hakkında teknik sorular sormak için harika bir yerdir. Stack Overflow hakkında soru sorma hakkında daha fazla bilgiyi Destek sayfasında bulabilirsiniz.

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

Mevcut tartışmalarda arama yapın. Muhtemelen başka biri de benzer bir sorunla karşılaşmış ve çözümü bulmuştur.
Mümkünse sitenizin bağlantısını gönderin. Yalnızca kod çevrimiçi olarak kolayca görüntülenemiyorsa kod snippet'lerini yayınlayın.
Tarayıcı sürümleri, hatalar ve bu sorunun giderilmesinde yararlı olabilecek diğer tüm gerçekleri içeren ilgili tüm bilgileri sağlayın.

Hatalar ve sorun giderme

Bu hata ne anlama geliyor?

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

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

Belirli koşullar altında, "yalnızca geliştirme amaçlı" metniyle filigranlanan koyu renkli bir harita veya "negatif" Street View resmi görüntülenebilir. Bu davranış genellikle bir API anahtarı veya faturalandırma ile ilgili sorunlar olduğunu gösterir. Google Haritalar Platformu ürünlerini kullanmak için bir faturalandırma hesabınızın olması ve tüm isteklerin geçerli bir API anahtarı içermesi gerekir. Aşağıdaki akış, bu sorunu gidermenize yardımcı olacaktır:

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ı aktarılır. API anahtarı kullanıp kullanmadığınızı kontrol etmek için kullanabileceğiniz birkaç seçeneği aşağıda bulabilirsiniz:

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

Google Haritalar JavaScript API uyarısı: NoApiKeys
Google Maps 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 kodda YOUR_API_KEY yerine kendi API anahtarınızı kullanın.
```
  <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, DevTools Ağ sekmesi kullanılarak görüntülenebilir. Burada, web sitenizin yaptığı ağ isteklerini görürsünüz. Maps JavaScript API kullanılarak yapılan istekler maps/api/js yolu altında yer alır. Burada, isteklerin key parametresini kullanıp kullanmadığını doğrulayabilirsiniz. Ağ sekmesini görüntülerken ağ trafiğinizi maps/api/js kriterine göre filtrelemek 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 sayfasındaki tüm talimatları uygulayın.
Başlayın

Evet, API anahtarı kullanıyorum.

Çok güzel! Şimdi devam edelim ve projenize bir faturalandırma hesabı eklenip eklenmediğini 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'daki 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ündeki sol kenar çubuğundan erişebileceğiniz Kimlik Bilgisi bölümüne gidin.
Web sitenizde kullanmakta olduğunuz API anahtarının listelendiğinden emin olun. Böyle bir durum söz konusu değilse farklı bir projeye geçin ve 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 bulunamıyorsa şunları yapmanız gerekir:
1. Yeni proje oluşturun. Bu işlem, proje listesinden Yeni Proje'yi veya Kaynak Yöneticisi sayfasından Proje Oluştur'u seçerek yapılabilir.
2. Yeni bir API anahtarı oluşturma. Bu işlem Credentials (Kimlik Bilgisi) sayfasında yapılabilir. Bu menüden Create credentials'ı (Kimlik bilgileri oluştur) tıklayın ve ardından API key'i (API anahtarı) seçin.

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

Hayır, projeme bağlı bir faturalandırma hesabı yok.

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 bölümüne bakın.

Evet, projeme bir faturalandırma hesabı eklendi.

Çok güzel! 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 kullanıcının belirlediği günlük sınır aşıldı mı?

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

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

İstenirse 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ğ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üvenliği sağlanabilen 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ğıdaki nedenlerden herhangi biri nedeniyle döndürülebilir:

İstekte bir API anahtarı eksik.
Sağlanan API anahtarı geçersiz.
Projeye eklenmiş bir faturalandırma hesabı yok.
Müşteri tarafından belirlenen bir kullanım sınırı aşıldı.
Belirtilen ödeme yöntemi artık geçerli değil (örneğin, bir kredi kartının 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ı alın.
Günlük sınırınızı (varsa) artırmak için 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ştirdiniz. Yetkisiz bir IP adresi, istekte bulunmaya çalışıyor.
API anahtarınızda HTTP yönlendiren (web sitesi) kısıtlamalarını etkinleştirdiniz ve yetkisiz bir yönlendiren bir istek üzerinde çalışıyor.
Paket adı ve parmak izi ayarlayarak Android uygulamalarınızın kullanımını kısıtladınız. Yetkisiz bir Android uygulaması, istekte bulunmaya çalışıyor.
Paket tanımlayıcıları belirterek iOS uygulamalarından gelen istekleri kısıtladınız ve tanınmayan bir iOS uygulaması, istek göndermeye çalışıyor.
Bu hatayı, HTTP yönlendiren kısıtlamalarına sahip bir API anahtarıyla web hizmeti API'lerinden herhangi birini kullandığınızda elde etmek mümkündü. Bu API'lere yapılan istekler, IP adresi kısıtlamalarına sahip bir API anahtarıyla tanımlanmalıdır. Anahtar kısıtlama türünüzü HTTP yönlendiren kısıtlamasından IP adresi kısıtlamasına geçirin. API anahtarlarını kısıtlama hakkında daha fazla bilgi için API Anahtarı İçin En İyi Uygulamalar bölümüne bakın.

API Anahtarı Kimlik Bilgilerinizi Görüntüleme ve Düzenleme

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

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

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

HTTP yönlendirenle kısıtlanmış bir API anahtarına sahip web hizmeti API'lerinden herhangi birini kullanıyorsunuz. Güvenlik nedeniyle web hizmeti API'lerinin, IP adresleriyle sınırlandırılmış API anahtarlarını kullanması gerekir. Anahtar kısıtlama türünüzü HTTP yönlendiren kısıtlamasından IP adresi kısıtlamasına geçirin. 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ın adı: google.maps.Geocoder.

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

Coğrafi kodlama hangi ülkelerde kullanılabilir?

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

Coğrafi kodlaması yapılmış konumların doğruluğu ülkeye göre değişebilir. Bu nedenle, uygulamanız için yeterince iyi bir eşleşme bulup bulmadığınızı belirlemek üzere döndürülen location_type alanını kullanmayı düşünmeniz gerekir. Coğrafi kodlama verilerinin kullanılabilirliği, veri sağlayıcılarla yaptığımız sözleşmelere bağlı olduğundan bu verilerin değişebileceğini lütfen unutmayın.

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

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

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

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

Adresleri, ilgili ülkenin ulusal posta servisi tarafından kullanılan biçime göre belirtin.
İlgili ülkenin posta servisi tarafından tanımlandığı şekilde adrese dahil olmayan işletme adları, birim numaraları, kat numaraları veya bina numaraları gibi ek adres öğeleri belirtmeyin. Bu işlem, ZERO_RESULTS yanıt almanıza neden olabilir.
Artı kodlarını burada gösterildiği gibi biçimlendirin (artı işaretler %2B için URL çıkışlı, boşluklar ise %20 için URL çıkışlıdır):
- global kod, 4 karakterli alan kodu ve 6 veya daha uzun bir yerel koddur (849VCWC8+R9, 849VCWC8%2BR9 şeklindedir).
- bileşik kod, açık bir konumu olan 6 karakter veya daha uzun bir yerel koddur (CWC8+R9 Mountain View, CA, ABD, CWC8%2BR9%20Mountain%20View%20CA%20USA şeklindedir).
Mümkünse bina adına öncelik vermek için binanın sokak numarasını kullanın.
Mümkün olduğunda ara sokakları belirtmek yerine sokak numarası adreslemeyi kullanın.
Yakındaki önemli noktalar gibi "ipuçları" vermeyin.

Coğrafi kodlama için ABD'deki bir adresini numaralı bir otoyolda nasıl biçimlendirmeliyim?

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

İlçe Yolları: "Co Road NNN" burada NNN yol numarasıdır. ör. "Co Road 82"
Eyalet Otoyolları: "State NNN" burada Eyalet, eyaletin tam adıdır ve NNN, otoyol numarasıdır. Ör. "California 82"
ABD Otoyolları: "U.S. NNN", burada NNN otoyol numarasıdır. ör. "U.S. 101"
ABD Eyaletler Arası: "Interstate NNN", burada NNN eyaletler arası numaradır. Ör. "Interstate 280"

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

Farklı coğrafi kodlama stratejilerinin artılarını ve eksilerini ayrıntılarıyla anlatan Coğrafi Kodlama Stratejileri belgesini inceleyin.

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

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

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

Hangi ülkelerde arabayla yol tarifi kullanılabiliyor?

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

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

Directions API ve DISTANCE Matrix API, Japonya'dakiler hariç tüm Google Transit 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. Belgelere ve örneklere buradan ulaşabilirsiniz.

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

KmlLayer sınıfını kullanan 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ı harita üzerinde nasıl görüntülerim?

Maps JavaScript API'de KML yer paylaşımları oluşturan KmlLayer sınıfı, KML dosyalarını oluşturmak ve ayrıştırmak için Google tarafından barındırılan bir hizmeti kullanır. Dolayısıyla, herkesin erişimine açık bir URL'de barındırılmayan veya erişim için kimlik doğrulaması gerektiren KML dosyalarını görüntülemek mümkün değildir.

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

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

Maps Static API tarafından desteklenen işaretçi veya yol köşelerinin sayısıyla ilgili bir sınırlama yoktur. Özel simgeler kullanılırken istek başına en fazla beş benzersiz simge belirtilebilir ancak 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 boyut,her bir enlem/boylam çifti belirtilirken kullanılan ondalık basamak sayısına göre belirtilebilecek işaretçi ve yol köşelerinin sayısını sınırlandırır. Kullanılan ondalık basamak sayısının Dünya'daki doğruluk oranıyla ilişkisi hakkında bilgi edinmek için Ondalık Dereceler hakkındaki Wikipedia makalesine göz atın.

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

Maps API'ler Yasaklanmış Bölgeler'de kullanılamaz. Ayrıca Hizmet Şartları'na da bakın.

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

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

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

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

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

Kritik veya zaman açısından hassas istekler için, düzeltilmesi gerekenlerle ilgili belirli 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 için başarılı veya başarısız olarak raporlanır. Bu bilgiler, Hizmet Düzeyi Sözleşmesi bilgilerini günlüğe kaydeden çağrılarda maps.googleapis.com/maps_api_js_slo/log numaralı telefondan Google'a gönderilir. Bu bilgiler arasında başarı durumu, gecikme ve kullanılan Maps JavaScript API'nin sürümü/kanalı bulunur. Çağrılar performans için toplu olarak gruplandırı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 izni vermeniz gerekebilir. Örneğin: HTTP üst bilgisi 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 boyunca çalışır?: Maps JavaScript API'yi yükleyen sayfayı en az 5 günde bir kez yenilemeniz gerekir.

iOS için Google Haritalar SDK'sı

kGMSPlacesRateLimitExceeded hatasını nasıl çö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ü kapatıldı ve artık kullanılamıyor. Lütfen en kısa sürede uygulamanızı son sürümü kullanacak şekilde güncelleyin. Ayrıntılar için taşıma rehberine göz atın.

iOS 8.x özellikli bir cihazla hata ayıklarken kilitlenmelerle karşılaşıyorum. Ne yapmalıyım?

iOS 8.x çalıştıran cihazlarda hata ayıklarken sorun yaşarsanız aşağıdaki adımları uygulayarak, çalıştırdığınız XCode şemasında GPU kare yakalamayı devre dışı bırakın:

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

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

Yuvarlatılmış ve daha geniş ekranların iOS için Google Haritalar SDK'sına etkisi nedir?

iPhone X'ten başlayarak iPhone'ların köşeleri yuvarlatılmış bir ekran şekli, cihazın sensör yuvasının üst tarafında bir çentik ve ekranın alt kısmında Ana ekrana erişim için bir gösterge bulunur. Apple, iOS 11.0 SDK'sından itibaren Safe Area API'yi ekledi. Bu API, geliştiricilerin öğeleri yeni ekran şeklinin kırpılmaya karşı güvenli bir alana yerleştirilmesine olanak tanıyor.

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

Google Haritalar iOS SDK'sı 2.5 sürümüyle birlikte bu düzen sorunları otomatik olarak düzeltilmiştir. 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, dolgunuz her zaman dahil edilir. Google Haritalar iOS SDK'sı, dolgunun güvenli alan içinden kaplanması amaçlandığını varsayar. Arayüzünüzü her şeyin güvenli alanda konumlandırıldığı varsayımıyla tasarlarsanız fazla çaba sarf etmeden işe yarar.

Varsayılan ayarlamamızla çalışmayan bir arayüz tasarladıysanız GMSMapView'da, pağlamaAyarla Davranış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 ayarlanırsa güvenli alan eklerini her zaman dolguya ekler. Bu, arayüzünüzü, tüm yerleşimlerin güvenli alanın kenarlarından olduğu varsayımıyla 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 olan dolgu veya güvenli alan girintisini seçer. Bu şekilde, tüm öğelerin her zaman güvenli alanda kalmasını sağlarken ekran kenarından dolgu ekleyebilirsiniz.

GMSMapView, "Hiçbir zaman" dolgu davranışını kullanacak şekilde ayarlanırsa güvenli alan girişleri dolguya hiçbir zaman eklenmez. 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ımız arayüzünüzde iyi performans göstermiyorsa 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 isteğe bağlı bir dolgu özelliğine sahip değildir. Yani, ayarlanması gereken dolgu olmaması ve GMSPanoramaView, tüm görsel öğelerin güvenli alanda olmasını sağlamak için gerekli olan dolguyu her zaman 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ü kapatıldı ve artık kullanılamıyor. Lütfen en kısa sürede uygulamanızı en son sürümü kullanacak şekilde güncelleyin. Ayrıntılar için taşıma rehberine göz atın.

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

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

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

Manifest'te yanlış/istenmeyen API anahtarına 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 eklenir.
Google Play Hizmeti bağımlılıkları build.gradle dosyasına dahil edilmez.

URL imzalama

JavaScript kullanarak URL'leri imzalayabilir miyim?

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

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

HTTP 403 yanıtı, bu istek için imzanın doğrulanamadığından bir izin sorunu olduğunu gösterir. Bunun nedeni aşağıdakilerden biri olabilir:

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