Bu belgede, Map Tiles API ile geliştirilen uygulamalara yönelik gereksinimler listelenmektedir. Map Tiles API'nin kullanımının Google ile olan Sözleşmenize tabi olduğunu unutmayın.
Kullanım şartlarını ve gizlilik politikasını sağlama
Bir Map Tiles API uygulaması geliştirirseniz, uygulamanızla birlikte Google ile Sözleşmenizde belirtilen kurallara uygun olan Kullanım Şartları'nı ve bir Gizlilik Politikası'nı sunmanız gerekir:
- Kullanım Şartları ve Gizlilik Politikası herkese açık olmalıdır.
- Uygulamanızın Kullanım Şartları'nda, uygulamanızı kullanan kullanıcıların Google’ın Hizmet Şartları'na tabi olduğunu açıkça belirtmelisiniz.
- Gizlilik Politikanızda kullanıcılara Google Haritalar API'lerini kullandığınızı bildirmeniz ve Google Gizlilik Politikası'nı referans olarak eklemeniz gerekir.
Kullanım Şartları ve Gizlilik Politikanız'ı kullanmanız için önerilen yer, uygulamanızın platformuna bağlıdır.
Mobil uygulamalar
Mobil uygulama geliştiriyorsanız uygulamanızın ilgili uygulama mağazasındaki indirme sayfasında ve uygulama ayarları menüsünde Kullanım Şartları ve Gizlilik Politikası'nın bağlantısını sağlamanız önerilir.
Web uygulamaları
Web uygulaması geliştiriyorsanız web sitenizin altbilgi bölümüne Kullanım Şartları ve Gizlilik Politikası'nın bağlantısını sağlamanız önerilir.
İçeriği önceden getirme, önbelleğe alma veya depolama
Map Tiles API'yi kullanan uygulamalar Google ile aranızdaki Sözleşme şartlarına tabidir. Sözleşmenizin şartlarına tabi olarak, şartlarda belirtilen sınırlı koşullar hariç hiçbir İçeriği önceden getirmemeli, dizine eklememeli, depolamamalı veya önbelleğe almamalısınız.
Özellikle, uygulamalar harita görselleştirmeleri için Map Tiles API'yi kullanmalıdır. Map Tiles API'yi aşağıdakiler gibi görselleştirme dışı kullanım alanları için kullanamazsınız:
- Görüntü analizi
- Makine çevirisi
- Nesne algılama/tanımlama
- Coğrafi verileri ayıklama veya yeniden satış
- Yukarıdakilerin herhangi biri dahil olmak üzere çevrimdışı kullanımlar
Map Tiles API yanıtları, HTTP protokol belgelerine göre uygulanması gereken Cache-Control üst bilgilerini içerebilir. Örneğin, istemciniz yanıtta iletildiğinde max-age değerine, stale-while-revalidate değerine, must-revalidate yönergesine ve private yönergesine uymalıdır.
Map Tiles API yanıtları, bir ETag üst bilgisi de içerebilir. Bu üst bilgi, yeniden doğrulamayla istekte bulunulurken HTTP protokolü belgelerine göre de uygulanması gerekir.
Bir yeri benzersiz şekilde tanımlamak için kullanılan yer kimliğinin, önbelleğe alma kısıtlamalarından muaf tutulduğunu unutmayın. Yer kimliği, Map Tiles API yanıtlarındaki "place_id" alanında döndürülür. Yer kimliklerinin nasıl kaydedileceğini, yenileneceğini ve yönetileceğini Yer Kimlikleri kılavuzundan öğrenebilirsiniz.
Google logosunu görüntüleme
Google Haritalar'ı görüntülemek için Harita Kutuları API'sini kullandığınızda, haritada Google logosunu da görüntülemeniz ve logoyu hiçbir şekilde değiştirmemeniz gerekir. Google logosunu haritanın sol alt köşesine, atıf bilgilerini ise haritanın sağ köşesine yerleştirmeniz gerekir. Daha fazla bilgi için Marka Kaynak Merkezi kurallarımıza göz atın.
Daha sinematik 3D harita deneyimlerinde, yani deneysel kullanıcı deneyimi tasarım gereksinimleriniz bu yerleşim yönergelerini karşılayamazsa, Google logosunu deneyimin başında, sonunda ya da her iki ucunda da açıkça göstermeniz gerekir. Böylece, haritayı oluşturan kişi kitleniz tarafından anlaşılabilir. Yine de sinema deneyiminin süresi boyunca üçüncü taraf veri ilişkilendirmelerini aşağıda açıklanan şekilde görüntülemeye uymanız gerekir. Daha fazla yardım için aşağıdaki Karma görselleştirmelerde logo ve veri ilişkilendirmelerini görüntüleme bölümüne bakın.
Aşağıdaki harita örneğinde, haritanın sol alt tarafındaki Google logosu ve sağ alt kısımda yer alan atıf gösterilmektedir.
| Açık renkli arka planda kullanım için | Koyu renkli arka planda kullanım için |
|---|---|
|
|
Aşağıdaki zip dosyası, Google logosunu masaüstü, Android ve iOS uygulamaları için doğru boyutlarda içermektedir. Bu logoları hiçbir şekilde yeniden boyutlandıramaz veya değiştiremezsiniz.
İndir: google_logo.zip
İlişkilendirmeyi değiştirmeyin. İlişkilendirme bilgilerini kaldırmayın, üzerini kapatmayın veya kırpmayın. Google logolarını satır içinde kullanamazsınız (örneğin, "Bu haritalar [Google_logo] logosuna aittir).
İlişkilendirmeyi yakın tutun. Doğrudan yerleştirmelerin dışında Google görüntülerinin ekran görüntülerini kullanıyorsanız standart atfı resimde göründüğü gibi ekleyin. Gerekirse metnin içeriğe yakın olması ve ortalama görüntüleyen ya da okuyucu tarafından okunabilmesi koşuluyla, atıf metninin stilini ve yerleşimini özelleştirebilirsiniz. Atıfları içerikten uzağa (örneğin, kitabınızın sonuna, dosyalarınızın veya programınızın jeneriklerine ya da web sitenizin alt bilgisine) taşıyamazsınız.
Üçüncü taraf veri sağlayıcıları dahil edin. Harita ürünlerimizdeki bazı veri ve resimler Google dışındaki sağlayıcılardan gelir. Bu tür görüntüler kullanıyorsanız ilişkilendirmenizin metninde "Google" adı ve ilgili veri sağlayıcıları belirtilmelidir(ör. "Harita verileri: Google, Maxar Technologies"). Görüntülerle birlikte atıfta bulunulan üçüncü taraf veri sağlayıcıları olduğunda, yalnızca "Google"ın veya Google logosunun eklenmesi uygun bir atıf değildir.
İlişkilendirme görünümünün pratik olmadığı bir cihazda Google Haritalar Platformu'nu kullanıyorsanız kullanım alanınıza uygun lisansları görüşmek için lütfen Google satış ekibiyle iletişime geçin.
Üçüncü taraf oluşturucularla Google logosunu gösterme
Google Haritalar'ı bir üçüncü taraf oluşturucu kullanarak görüntülemek için Harita Kutuları API'sını kullandığınızda, Google logosunu, oluşturucunun logosu gibi başka bir logoyla örtmemeli veya gizlememelisiniz. Google logosu ile üçüncü taraf logosu arasında makul bir tampon mesafe bırakarak bunların bağımsız logolar olarak görünmesini sağlayın. Hiçbir logo, API yanıtı tarafından sağlanan veri ilişkilendirmesini örtüşemez veya engelleyemez.
Google'ın veri ilişkilendirmelerini görüntüleme
Map Tiles API'den döndürülen veriler, uygun meta veri veya görüntü alanı bilgi isteklerinden atıf ve telif hakkı bilgilerinin gösterilmesini gerektirir. Bu bilgileri, sağlandığı şekilde uygun konumda, genellikle görüntülenen karo grubunun sağ alt köşesinde veya 3D oluşturucu görünümünde göstermeniz gerekir. İlişkilendirme dizelerinin, oluşturucunun görüntü alanı tarafından istenen harita verilerine bağlı olarak değişken olduğunu unutmayın.
Görüntü alanı boyut kısıtlamaları nedeniyle veri ilişkilendirmelerini tam olarak görüntülemek mümkün değilse ilişkilendirme bilgileri sağlamak için harita penceresinde açılan "Veri kaynakları" etiketli bir fareyle üzerine gelme veya tıklanabilir kullanıcı arayüzü öğesi eklemeyi düşünün. Daima iyi haritacılık uygulamalarını devam ettirmeyi hedefleyin.
Üçüncü taraf veri ilişkilendirmelerini görüntüleme
Bir Google Haritalar verilerini temel harita olarak görüntülemek ve üçüncü taraf (Google'a ait olmayan) coğrafi verilerle yer paylaşmak için Map Tiles API'yi kullandığınızda, üçüncü taraf veri sağlayıcısından gelen atfı görüntülemeniz gerekebilir. Google veri ilişkilendirmesini, üçüncü taraf verilerine ait veri ilişkilendirmesiyle hiçbir şekilde örtüşmemeli veya gizlememelisiniz. Üçüncü taraf verilerinin ilişkilendirilmesi, Google'ın veri ilişkilendirmelerinden açıkça kaldırılmalıdır. Ayrıca, Google'ın logosunun ve Google'ın veri ilişkilendirmesinin temel harita ve birbirleriyle ilişkili olduğu açıkça belirtilmelidir.
Karma görselleştirmelerde logo ve veri ilişkilendirmelerini görüntüleme
Google Haritalar verilerini kendi harita verilerinizin üzerine yerleştirirken temel harita olarak kullandığınızda, hedef kitlenizin, harita görselleştirmenin hangi kısmının Google'a ve hangi bölümlerin kendi harita verilerinizle ilişkilendirildiğini tam olarak anlamasını sağlamanız gerekir. Ayrıca, yukarıdaki Google logosunu görüntüleme bölümünde yer alan yönergeleri uygulayın.
Örneğin, Fotogerçekçi 3D Karoları (arka plan dolgusu olarak) kendi fotogerçekçi modellerinizle (ön plan) birleştirmeyi düşünün. Sahnenin hangi bileşenlerinin Google Haritalar verilerinden geldiği konusunda kullanıcılar kafa karışıklığı yaşayabilir. Bu gibi durumlarda, sahnenin hangi bölümünün Google Haritalar verilerinden geldiğini kullanıcı arayüzü ilişkilendirme dizenizde veya kullanıcı işlemleri akışınızda açıkça belirtmeniz gerekir. Google Haritalar verileriyle kullandığınız veri kaynakları için geçerli olabilecek tüm üçüncü taraf ilişkilendirme şartlarına uymak sizin sorumluluğunuzdadır.
Fotogerçekçi 3B Karolarla coğrafi veri bindirmeleri
3D nesneler, Fotogerçekçi 3D Karolardan elde edilmediği, izlenmediği veya elle ya da makineyle başka bir şekilde elde edilmediği sürece, Kendi 3D nesnelerinizi Fotogerçekçi 3D Karoların üzerine bindirebilirsiniz.
Map Tiles API'yi öne çıkaran video oluşturma
- Tanıtım Videoları: Sözleşme şartlarına ve aşağıdakilere tabi olarak tanıtım videoları oluşturabilirsiniz:
- Tanıtım videosunda Street View görüntüleri bulunmamalıdır.
- Tanıtım videosunun uzunluğu 30 saniyeyi aşmamalıdır.
- Tanıtım videosu, uygulamalarınızın özellikleri hakkında olmalıdır.
- Tanıtım videosu, "yalnızca tanıtım amaçlı" açıkça işaretlenmeli ve Harita Karoları API Politikaları'ndaki İlişkilendirme Yönergeleri'ne uymalıdır.
- Tanıtım videosu ayrı olarak veya yazılımın, uygulamanın ya da kullanıcı deneyiminin bir parçası olarak yeniden satılamaz.
- Yayından Kaldırma: Üçüncü taraflardan gelen talepler de dahil olmak üzere Tanıtım Videosunun yayından kaldırılmasına yönelik tüm taleplere uymak sizin sorumluluğunuzdadır.
Atıf ve telif hakkı bilgilerini alma
Kullandığınız hizmete bağlı olarak aşağıdaki API çağrılarının yanıtlarında copyright alanından ilişkilendirme ve telif hakkı bilgilerini alın:
2D karolar
Yol haritası, Uydu ve Arazi bölümleri
Telif hakkı ve atıf bilgileri, aşağıdaki örnekte gösterildiği gibi görüntü alanı bilgileri yanıtından edinilebilir.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
...
]
}
Street View Karoları
Telif hakkı ve atıf bilgilerine, Street View meta veri yanıtından ulaşılabilir. Örneğin:
{
"panoId": "Zzl28rqGJgaL2IdkUleP8A",
"lat": 50.059138596550696,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"copyright": "From the Owner, Photo by: Google",
…
}
Bir Street View panoramasını benzersiz şekilde tanımlamak için kullanılan panorama kimliği, önbelleğe alma kısıtlamasından muaftır. Bu nedenle, panorama kimlik değerlerini süresiz olarak saklayabilirsiniz. Panorama kimliği değerleri, Street View Static API yanıtlarındaki panoId alanında döndürülür.
Gerçekçi Fotoğraf 3B Parçalar
Fotogerçekçi 3D Döşemeler için, her karo isteğinde ilişkilendirme verileri döndürülür.
Görüntülenen karolarla ilgili tüm ilişkilendirmeleri, genellikle oluşturma işleminin altında toplamalı, sıralamalı ve bir satırda görüntülemelisiniz. Örneğin, bir glTF parçasındaki veri ilişkilendirmelerini asset veya copyright altına bakarak bulabilirsiniz.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
CesiumJS
Oluşturucu olarak CesiumJS kullanıyorsanız ilişkilendirmeleri görüntülemek için oluşturma HTML'nizde showCreditsOnScreen öğesini etkinleştirmeniz gerekir.
// Add Photorealistic 3D Tiles tileset.
const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
// This property is needed to appropriately display attributions
// as required.
showCreditsOnScreen: true,
}));
Unreal için Sezyum
Oluşturucu olarak Unreal için Cesium'u kullanıyorsanız atıfları görüntülemek için Dünya Anahatçısı'ndaki Kredileri Ekranda Göster alanını etkinleştirmeniz gerekir.
Unity için Sezyum
Oluşturucu olarak Unity için Cesium kullanıyorsanız atıfları görüntülemek için İnceleyici konsolunda Kredileri Ekranda Göster alanını etkinleştirmeniz gerekir.
Google ilişkilendirmesi için stil yönergeleri
İndirilebilir Google logosunu kullanamıyorsanız CSS ve HTML'de Google ilişkilendirmeleri için stil kurallarını aşağıda bulabilirsiniz.
Boş alan
Tam logonun çevresindeki boş alan, Google'daki "G" harfinin yüksekliğine eşit veya bu yükseklikten büyük olmalıdır.
İlişkilendirme metni ile Google logosu arasındaki alan, "G" harfinin genişliğinin yarısı kadar olmalıdır.
Okunabilirlik
İmza satırı her zaman net ve okunabilir olmalı, belirli bir arka plan için doğru renk varyasyonunda görünmelidir. Seçtiğiniz logo varyasyonu için daima yeterli kontrast sağladığınızdan emin olun.
Renk
En fazla %0-%40 arasında siyah tonu kullanan beyaz veya açık renkli bir arka plan üzerinde Google Material Gray 700 metin kullanın.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Koyu arka planlarda ve fotoğraf veya meşgul olmayan desenlerin üzerinde künyeye ekleme ve ilişkilendirme için beyaz metin kullanın.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Yazı tipi
Roboto yazı tipini kullanın.
Örnek CSS
Aşağıdaki CSS "Google" metnine uygulandığında, "Google" kelimesini uygun yazı tipi, renk ve boşlukla beyaz veya açık arka planla görüntüler.
font-family: Roboto; font-style: normal; font-weight: 500; font-size: 16px; line-height: 16px; padding: 16px; letter-spacing: 0.0575em; /* 0.69px */ color: #5F6368;