Dokumen ini mencantumkan persyaratan khusus untuk semua aplikasi yang dikembangkan dengan Places SDK for iOS, termasuk layanan Place Autocomplete yang merupakan bagian dari API tersebut. Informasi yang lebih umum untuk developer Google Maps dapat ditemukan dalam Persyaratan Layanan Google Maps Platform.
Menyediakan ketentuan penggunaan dan kebijakan privasi
Jika Anda mengembangkan aplikasi Places SDK for iOS, Anda harus menyediakan Persyaratan Penggunaan dan Kebijakan Privasi bersama aplikasi Anda yang memenuhi pedoman yang diuraikan dalam Perjanjian Anda dengan Google:
- Persyaratan Penggunaan dan Kebijakan Privasi harus tersedia untuk publik.
- Anda harus menyatakan secara eksplisit dalam Persyaratan Penggunaan aplikasi bahwa dengan menggunakan aplikasi Anda, pengguna akan terikat dengan Persyaratan Layanan Google.
- Anda harus memberi tahu pengguna dalam Kebijakan Privasi Anda bahwa Anda menggunakan Google Maps API dan menyertakannya dengan merujuk Kebijakan Privasi Google.
Tempat yang direkomendasikan untuk menyediakan Persyaratan Penggunaan dan Kebijakan Privasi Anda bergantung pada platform aplikasi Anda.
Aplikasi seluler
Jika mengembangkan aplikasi seluler, sebaiknya Anda menyediakan link ke Persyaratan Penggunaan dan Kebijakan Privasi di halaman download aplikasi Anda di app store yang relevan dan di menu setelan aplikasi.
Aplikasi web
Jika mengembangkan aplikasi web, sebaiknya berikan link ke Persyaratan Penggunaan dan Kebijakan Privasi di footer situs Anda.
Pra-Pengambilan, Pembuatan Cache, atau Penyimpanan Konten
Aplikasi yang menggunakan Places SDK for iOS terikat dengan persyaratan Perjanjian Anda dengan Google. Dengan tunduk pada Perjanjian ini, Anda tidak boleh melakukan pra-pengambilan, mengindeks, menyimpan dalam cache, atau menyimpan Konten kecuali dalam kondisi terbatas yang dinyatakan dalam persyaratan.
Menampilkan hasil Places SDK for iOS
Anda dapat menampilkan hasil Places SDK for iOS di Google Maps, atau tanpa peta. Jika Anda ingin menampilkan hasil Places SDK for iOS pada peta, hasil ini harus ditampilkan di Google Maps. Dilarang menggunakan data Places SDK for iOS pada peta yang bukan peta Google.
Menampilkan logo dan atribusi Google
Jika aplikasi Anda menampilkan data di Google Maps, logo Google akan disertakan dan tidak dapat diubah. Aplikasi yang menampilkan data Google pada layar yang sama dengan Google Maps tidak perlu memberikan atribusi lebih lanjut untuk Google.
Jika aplikasi Anda menampilkan data pada halaman atau tampilan yang juga tidak menampilkan Google Maps, Anda harus menampilkan logo Google dengan data tersebut. Misalnya, jika aplikasi Anda menampilkan data Google pada satu tab, dan Google Maps dengan data tersebut pada tab lain, tab pertama harus menampilkan logo Google. Jika aplikasi Anda menggunakan kolom penelusuran dengan atau tanpa pelengkapan otomatis, logo harus ditampilkan inline.
Logo Google harus ditempatkan di sudut kiri bawah peta, dengan informasi atribusi ditempatkan di sudut kanan bawah, yang keduanya harus ada di peta secara keseluruhan dan tidak di bawah peta atau tempat lain dalam aplikasi. Contoh peta berikut menunjukkan logo Google di kiri bawah peta, dan atribusi di kanan bawah.
| Untuk digunakan pada latar belakang terang | Untuk digunakan pada latar belakang gelap |
|---|---|
|
|
File zip berikut berisi logo Google dalam ukuran yang tepat untuk aplikasi desktop, Android, dan iOS. Anda tidak boleh mengubah ukuran atau memodifikasi logo-logo ini dengan cara apa pun.
Download: google_logo.zip
Jangan ubah atribusi. Jangan menghapus, mengaburkan, atau memotong informasi atribusi. Anda tidak dapat menggunakan logo Google inline (misalnya, "Peta ini berasal dari [Google_logo]").
Pastikan atribusi tetap dekat. Jika menggunakan screenshot citra Google di luar sematan langsung, sertakan atribusi standar seperti yang muncul dalam gambar. Jika perlu, Anda dapat menyesuaikan gaya dan penempatan teks atribusi, asalkan teks berada dalam jarak yang dekat dengan konten dan dapat dibaca oleh rata-rata pembaca atau pembaca. Anda tidak boleh memindahkan atribusi dari konten, seperti ke bagian akhir buku, kredit file atau acara, atau footer situs Anda.
Sertakan penyedia data pihak ketiga. Beberapa data dan gambar pada produk pemetaan kami berasal dari penyedia selain Google. Jika menggunakan gambar tersebut, teks atribusi Anda harus menyebutkan nama "Google" dan penyedia data yang relevan, seperti "Data peta: Google, Maxar Technologies." Jika ada penyedia data pihak ketiga yang dirujuk dengan citra, hanya menyertakan "Google" atau logo Google bukan atribusi yang tepat.
Jika Anda menggunakan Google Maps Platform pada perangkat yang tidak memungkinkan tampilan atribusi, harap hubungi tim penjualan Google untuk mendiskusikan lisensi yang sesuai untuk kasus penggunaan Anda.
Persyaratan atribusi lainnya
Atribusi ke penyedia pihak ketiga berisi konten dan link yang harus Anda tampilkan kepada pengguna dalam format yang telah mereka sediakan. Google menyarankan agar aplikasi Anda menampilkan informasi ini di bawah detail tempat.
Atribusi pihak ketiga yang ditampilkan oleh API tidak menyertakan atribusi Google. Anda harus menyertakan atribusi ini sendiri, seperti yang dijelaskan dalam artikel Menampilkan logo dan atribusi Google.
Ikuti petunjuk ini untuk mengambil atribusi pihak ketiga untuk satu tempat atau kumpulan tempat.
Menampilkan atribusi untuk satu tempat
Saat mengambil tempat dengan mendapatkan
tempat berdasarkan ID, Anda
dapat mengambil atribusi untuk tempat tersebut dari
properti attributions pada
GMSPlace.
attributions disediakan sebagai objek NSAttributedString.
Mengambil atribusi untuk sekumpulan tempat
Jika aplikasi Anda menampilkan informasi yang diperoleh dengan meminta tempat saat ini dari perangkat, aplikasi tersebut harus menampilkan atribusi pihak ketiga untuk detail tempat yang ditampilkan. Anda dapat mengambil
atribusi untuk semua tempat yang diambil dalam permintaan, dari
properti attributions pada
GMSPlaceLikelihoodList.
attributions disediakan sebagai objek NSAttributedString, yang dapat Anda akses dan tampilkan dengan cara yang sama seperti attributions di satu tempat, seperti yang dijelaskan di atas.
Menampilkan atribusi untuk foto
Jika aplikasi Anda menampilkan foto, Anda harus
menampilkan atribusi untuk setiap foto yang memilikinya. Untuk mendapatkan atribusi bagi
foto, panggil
GMSPlacePhotoMetadata.attributions. Properti ini berupa
NSAttributedString, atau nil jika tidak ada atribusi
yang ditampilkan.
Swift
GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in
if let error = error {
// TODO: handle the error.
print("Error: \(error.description)")
} else {
// Get attribution for the first photo in the list.
if let photo = photos?.results.first {
let attributions = photo.attributions
}
}
}
Objective-C
[[GMSPlacesClient sharedClient]
lookUpPhotosForPlaceID:placeID
callback:^(GMSPlacePhotoMetadataList *_Nullable photos,
NSError *_Nullable error) {
if (error) {
// TODO: handle the error.
NSLog(@"Error: %@", [error description]);
} else {
// Get attribution for the first photo in the list.
if (photos.results.count > 0) {
GMSPlacePhotoMetadata *photo = photos.results.firstObject;
NSAttributedString *attributions = photo.attributions;
}
}
}];
Menampilkan atribusi pihak ketiga
Atribusi untuk pihak ketiga disediakan sebagai objek NSAttributedString yang berisi konten dan link yang harus Anda pertahankan dan tampilkan kepada pengguna.
Cara yang direkomendasikan untuk menampilkan atribusi adalah dengan menggunakan UITextView, karena link dalam atribusi harus berfungsi.
Untuk memastikan link berfungsi, tetapkan delegasi pada UITextView dan tetapkan metode shouldInteractWithURL dari UITextViewDelegate Anda untuk menampilkan YES.
Swift
...
self.attributionTextView.delegate = self
...
// MARK: - UITextViewDelegate
func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
inRange characterRange: NSRange) -> Bool {
// Make links clickable.
return true
}
Objective-C
...
self.attributionTextView.delegate = self;
...
#pragma mark - UITextViewDelegate
- (BOOL)textView:(UITextView *)textView
shouldInteractWithURL:(NSURL *)url
inRange:(NSRange)characterRange {
// Make links clickable.
return YES;
}
Contoh atribusi pihak ketiga
Atribusi pihak ketiga biasanya terdiri dari teks beserta tautan. Contoh:
Listingan oleh Contoh Perusahaan
Pada contoh di atas, rentang teks Contoh Perusahaan dicakup oleh
atribut NSLink.
Perhatikan bahwa ID tempat, yang digunakan untuk mengidentifikasi tempat secara unik, dikecualikan dari pembatasan penyimpanan dalam cache. Karena itu Anda bisa menyimpan nilai
ID tempat tanpa batas. ID tempat ditampilkan dalam kolom place_id di respons Places SDK for iOS.
Panduan gaya untuk atribusi Google
Berikut adalah pedoman gaya untuk atribusi Google dalam CSS dan HTML jika Anda tidak dapat menggunakan logo Google yang dapat didownload.
Ruang kosong
Jumlah ruang kosong di sekitar logo lengkap harus sama dengan atau lebih besar dari tinggi quot;G" di Google.
Lebar antara teks atribusi dan logo Google harus setengah dari lebar "G".
Keterbacaan
Baris nama penulis harus selalu jelas, dapat dibaca, dan muncul dalam variasi warna yang tepat untuk latar belakang tertentu. Pastikan untuk memberikan kontras yang cukup untuk variasi logo yang Anda pilih.
Warna
Menggunakan teks Google Material Gray 700 pada latar belakang putih atau terang yang menggunakan rentang tint maksimum 0%–40%.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Pada latar belakang yang lebih gelap, dan pada foto fotografi atau non-sibuk, gunakan teks putih untuk byline dan atribusi.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Font
Gunakan font Roboto.
Contoh CSS
CSS berikut, saat diterapkan ke teks "Google," akan merender "Google" dengan font, warna dan spasi yang sesuai pada latar belakang putih atau terang.
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;