Dokumen ini mencantumkan persyaratan yang spesifik 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 di Persyaratan Layanan Google Maps Platform.
Kebijakan
Bagian ini menjelaskan kebijakan yang relevan dengan Places SDK for iOS. Kebijakan memberikan panduan dan persyaratan penerapan praktis untuk membantu Anda menggunakan Layanan dengan benar dan sesuai dengan ekspektasi Google Maps Platform.
Penyimpanan data, caching, dan scraping
Saat menggunakan Konten Google Maps di aplikasi Anda, ikuti persyaratan penanganan data di Pasal 3.2.3 Persyaratan Layanan Google Maps Platform dan Persyaratan Spesifik Per Layanan Google Maps Platform:
- Batasan penyimpanan dalam cache dan scraping (Pasal 3.2.3(a) dan (b)): Simpan dalam cache atau simpan Konten Google Maps hanya sebagaimana diizinkan secara tegas berdasarkan Persyaratan Khusus Layanan Google Maps Platform. Jangan mengekspor, mengekstrak, atau melakukan scraping pada Konten Google Maps untuk digunakan di luar Layanan. Misalnya, jangan mengambil, mengindeks, menyimpan, atau mendistribusikan ulang Konten Google Maps di luar Layanan; mendownload ubin peta, gambar Street View, geocode, rute, hasil matriks jarak, informasi jalan, informasi tempat, nilai elevasi, atau detail zona waktu secara massal; atau menyalin dan menyimpan nama bisnis, alamat, atau ulasan pengguna.
- Batasan konten turunan (Pasal 3.2.3(c)): Gunakan Konten Google Maps dalam aplikasi Anda sebagaimana diizinkan oleh Persyaratan Layanan Google Maps Platform. Jangan membuat konten berdasarkan Konten Google Maps. Misalnya, jangan melacak atau mendigitalkan fitur dari citra satelit, membuat model 3D atau medan, menggunakan nilai lintang dan bujur Tempat sebagai input untuk analisis titik dalam poligon, membuat indeks lokasi dari gambar Street View, atau mengonversi waktu tempuh berbasis teks menjadi ucapan yang disintesis.
Untuk mengurangi latensi dan biaya penagihan tanpa meng-cache data yang dibatasi, gunakan mask kolom atau daftar kolom untuk hanya meminta kolom yang diperlukan antarmuka pengguna Anda. Simpan ID yang dikecualikan seperti ID tempat untuk mengambil detail terbaru saat pengguna berinteraksi dengan tempat.
Engineer dukungan teknis Google tidak dapat memberikan saran hukum atau memberikan pengecualian terhadap Persyaratan Layanan Google Maps Platform. Hubungi penasihat hukum Anda untuk menentukan apakah penerapan Anda mematuhi persyaratan, atau hubungi Bagian Penjualan jika kasus penggunaan Anda memerlukan pemberian lisensi kustom.
Pengecualian dari batasan penyimpanan dalam cache
Persyaratan Khusus Layanan Google Maps Platform memberikan pengecualian penyimpanan cache terbatas berikut:
- ID Tempat: ID tempat, yang digunakan untuk mengidentifikasi tempat secara unik, dikecualikan dari pembatasan penyimpanan dalam cache.
Karena itu Anda bisa menyimpan nilai ID tempat secara tak terbatas. ID tempat ditampilkan di kolom
idatauplace_iddalam respons API. Pelajari cara menyimpan, memperbarui, dan mengelola ID tempat di panduan ID Tempat. - Koordinat lintang dan bujur: Anda dapat meng-cache nilai lintang (
latitude) dan bujur (longitude) untuk sementara hingga 30 hari kalender berturut-turut, setelah itu Anda harus menghapus koordinat yang di-cache, saat menggunakan layanan yang memberikan pengecualian ini dalam Persyaratan Khusus Layanan Google Maps Platform:- Routes API, Route Optimization API, Directions API (Lama), dan Roads API
- Geocoding API, Geolocation API, dan Address Validation API
- Places API, Kit UI Places, dan Navigation SDK
- Periode penyimpanan data dalam cache khusus layanan: Persyaratan Khusus Layanan Google Maps Platform juga menentukan periode penyimpanan data dalam cache khusus kolom dan tujuan yang diizinkan untuk Address Validation API, Air Quality API, Pollen API, Solar API, Weather API, dan Places Aggregate API.
Negara dan wilayah Wilayah Ekonomi Eropa
Produk ini memiliki Persyaratan Layanan yang berbeda untuk pelanggan dengan alamat penagihan di Wilayah Ekonomi Eropa (EEA), dan mungkin juga memiliki fungsi yang berbeda. Sebelum membangun dengan Google Maps Platform, tinjau persyaratan dan informasi khusus EEA berikut:
- Persyaratan Layanan Google Maps Platform untuk EEA
- Persyaratan Spesifik Per Layanan Google Maps Platform EEA
- Pertanyaan umum (FAQ) terkait EEA
- Persyaratan Keselamatan Jalan Google Maps Platform
Jika alamat penagihan Anda tidak berada di EEA, persyaratan layanan berikut berlaku untuk Anda:
Persyaratan atribusi Google Maps
Bagian ini memberikan persyaratan dan panduan atribusi untuk menampilkan Google Maps dan Konten melalui aplikasi Anda.
Contoh atribusi
Berikut adalah contoh atribusi untuk Places UI Kit.
Menampilkan atribusi Google Maps
Anda harus mengikuti persyaratan atribusi Google Maps saat menampilkan Konten dari API Google Maps Platform di aplikasi atau situs Anda. Anda tidak perlu menambahkan atribusi tambahan jika Konten ditampilkan di Google Maps yang atribusinya sudah terlihat.
Atribusi Google Maps yang disertakan
Untuk atribusi Google Maps yang sudah disediakan oleh Google Maps Platform di antarmuka pengguna, seperti di Kit UI Places:
- Jangan hapus atribusi yang disertakan, di mana pun atribusi tersebut ditampilkan. Jangan mengubah, menyembunyikan, atau mengaburkan atribusi dan pastikan atribusi terlihat jelas di latar belakang.
- Selalu bedakan Konten Google Maps Platform secara visual dari konten lain menggunakan petunjuk UI seperti batas, warna latar belakang, bayangan, atau spasi kosong yang memadai.
- Saat melakukan modifikasi visual, Anda harus mematuhi semua persyaratan atribusi Google Maps.
Logo Google Maps dan atribusi teks
Atribusi harus berupa logo Google Maps jika memungkinkan. Jika ruang terbatas, teks Google Maps dapat diterima. Pengguna akhir harus selalu mengetahui dengan jelas konten mana yang disediakan oleh Google Maps.
Atribusi logo
Ikuti persyaratan berikut untuk menggunakan logo Google Maps di aplikasi atau situs Anda.Download logo Google Maps
Gunakan file logo Google Maps resmi. Download logo di bawah, dan ikuti panduan di bagian ini.
Mendownload aset atribusi Google MapsSaat menggunakan logo Google Maps, ikuti panduan ini.
- Jangan mengubah logo dengan cara apa pun.
- Pertahankan rasio aspek logo untuk mencegah distorsi.
- Gunakan logo bergaris tepi pada latar belakang yang ramai, seperti peta atau gambar.
- Gunakan logo tanpa garis batas pada latar belakang polos, seperti warna solid atau gradien halus.
Spesifikasi ukuran logo
Ikuti spesifikasi ukuran berikut untuk logo Google Maps:- Tinggi logo minimum: 16 dp
- Tinggi logo maksimum: 19dp
- Ruang kosong logo minimum: 10 dp di kiri, kanan, dan atas, 5 dp di bawah
Untuk mempelajari dp, lihat Kepadatan piksel di situs Desain Material.
Aksesibilitas logo
Ikuti persyaratan aksesibilitas berikut untuk logo Google Maps:- Pertahankan kontras yang mudah diakses antara logo dan latar belakang.
- Sertakan label aksesibilitas dengan teks Google Maps.
Atribusi teks
Jika ukuran antarmuka Anda tidak mendukung penggunaan logo Google Maps, Anda dapat mengeja Google Maps dalam teks. Ikuti pedoman berikut:
- Jangan ubah teks Google Maps dengan cara apa pun:
- Jangan ubah kapitalisasi Google Maps
- Jangan gabungkan Google Maps ke dalam beberapa baris
- Jangan lokalkan Google Maps ke bahasa lain.
- Cegah browser menerjemahkan Google Maps dengan menggunakan atribut HTML
translate="no".
Atur gaya teks Google Maps seperti yang dijelaskan dalam tabel berikut:
Persyaratan gaya teks Google Maps Properti Gaya Jenis font Roboto. Pemuatan font bersifat opsional. Jenis font pengganti Font isi sans serif apa pun yang sudah digunakan dalam produk Anda atau "Sans-Serif" untuk memanggil font sistem default Gaya font Normal Ketebalan font 400 Warna font Putih, hitam (#1F1F1F), atau abu-abu (#5E5E5E). Pertahankan kontras yang mudah diakses (4,5:1) terhadap latar belakang. Ukuran font Ukuran font minimum: 12sp
Ukuran font maksimum: 16sp
Untuk mempelajari sp, lihat Unit ukuran font di situs Desain Material.Spasi huruf Normal
CSS Contoh
CSS berikut merender Google Maps dengan gaya dan warna tipografi yang sesuai di latar belakang putih atau terang.
@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap'); .GMP-attribution { font-family: Roboto, Sans-Serif; font-style: normal; font-weight: 400; font-size: 1rem; letter-spacing: normal; white-space: nowrap; color: #5e5e5e; }
Persyaratan visual
Ikuti persyaratan berikut untuk perlakuan visual atribusi Google Maps.Posisikan atribusi di dekat bagian atas atau bawah konten, dan dalam penampung visual yang sama. Untuk satu baris konten, atribusi dapat diposisikan di kanan atau kiri.
Bedakan Konten Google Maps Platform secara visual dari konten lain menggunakan petunjuk UI seperti batas, warna latar belakang, bayangan, atau spasi kosong yang memadai.
- Jangan memberikan pernyataan tidak benar tentang Google Maps dengan mengatribusikannya ke konten non-Google Maps Platform.
- Pastikan atribusi selalu terlihat dan terbaca. Jangan pernah menghapus, menyembunyikan, mengaburkan, atau mengubahnya.
Gambar berikut menunjukkan contoh persyaratan visual ini.
Penyedia data pihak-ketiga
Beberapa data dan gambar di produk pemetaan kami berasal dari penyedia selain Google. Untuk beberapa produk, seperti Map Tiles API, kami dapat memberikan atribusi yang diperlukan kepada penyedia data pihak ketiga. Jika kami melakukannya, teks atribusi Anda harus berisi nama "Google Maps" dan penyedia data yang relevan, seperti "Data peta: Google, Maxar Technologies". Jika Google memberikan atribusi pihak ketiga, menyertakan "Google Maps" atau logo Google saja bukanlah bentuk atribusi yang benar.
Persyaratan atribusi lainnya
Atribusi ke penyedia pihak ketiga berisi konten dan link yang harus Anda tampilkan kepada pengguna dalam format yang disediakan. Google merekomendasikan 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 Menampilkan logo Google dan atribusi.
Ikuti petunjuk ini untuk mengambil atribusi pihak ketiga untuk satu tempat atau kumpulan tempat.
Mengambil atribusi untuk satu tempat
Saat mengambil tempat dengan mendapatkan tempat berdasarkan ID, Anda dapat mengambil atribusi untuk tempat tersebut dari properti attributions di GMSPlace.
attributions disediakan sebagai
objek NSAttributedString.
Mengambil atribusi untuk kumpulan tempat
Jika aplikasi Anda menampilkan informasi yang diperoleh dengan meminta lokasi saat ini perangkat, aplikasi harus menampilkan atribusi pihak ketiga untuk detail tempat yang ditampilkan. Anda dapat mengambil
atribusi untuk semua tempat yang diambil dalam permintaan, dari
properti attributions di
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.
Atribusi hasil penelusuran
Di Eropa, saat menggunakan peringkat Google yang tidak dimodifikasi, produk penelusuran harus memiliki teks penjelasan yang dapat diakses dengan maksimal 1 klik, yang menjelaskan faktor utama dan bobot faktor utama yang menentukan peringkat hasil penelusuran. Teks penjelasan:
Header: Tentang hasil ini
Teks: Saat Anda menelusuri bisnis atau tempat di dekat suatu lokasi, Google Maps akan menampilkan hasil lokal. Beberapa faktor, terutama relevansi, jarak, dan keterlihatan, digabungkan untuk membantu menemukan hasil penelusuran terbaik.
Tombol 1: Pelajari lebih lanjut
Teks "Pelajari lebih lanjut" harus ditautkan ke artikel Pusat Bantuan.
Tombol 2: OK
Menampilkan atribusi untuk foto
Jika aplikasi Anda menampilkan
foto, Anda harus
menampilkan attributions dan authorAttributions untuk setiap
foto yang memilikinya.
- Untuk mengakses atribusi apa pun, gunakan
GMSPlacePhotoMetadata.attributions. Properti ini adalahNSAttributedString, atauniljika tidak ada atribusi untuk ditampilkan. - Untuk mengakses atribusi penulis, gunakan
GMSPlacePhotoMetadata.authorAttributions. Properti ini berisi array objekGMSPlaceAuthorAttribution.
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 ulasan
Objek GMSPlace dapat berisi hingga lima ulasan, yang setiap ulasannya diwakili oleh objek GMSPlaceReview. Secara opsional, Anda dapat menampilkan ulasan tersebut di aplikasi Anda.
Jika menampilkan ulasan yang merupakan kontribusi dari pengguna Google, Anda harus menempatkan nama penulis di dekat ulasan. Jika ada di kolom atribusi penulis
untuk objek GMSPlaceReview, sebaiknya Anda menyertakan juga foto
dan link penulis ke profil mereka. Gambar berikut menampilkan contoh ulasan sebuah taman:

Google juga merekomendasikan agar Anda menampilkan cara ulasan diurutkan kepada pengguna akhir.
Untuk mengakses ulasan:
Swift
// Define a Place ID. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" // Specify the place data types to return. let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews] // Create the GMSFetchPlaceRequest object. let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties) client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: { (place: GMSPlace?, error: Error?) in if let error = error { print("An error occurred: \(error.localizedDescription)") return } if let place = place { let firstReview: GMSPlaceReview = place.reviews![0] // Use firstReview to access review text, authorAttribution, and other fields. } })
Objective-C
// Define a Place ID. NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs"; // Specify the place data types to return, including reviews. NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews]; GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties]; [placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) { if (error) { // TODO: handle the error. NSLog(@"Error: %@", [error description]); } else { // Get first review. GMSPlaceReview *firstReview = [place reviews][0]; // Use firstReview to access review text, authorAttribution, and other fields. } }];
Menampilkan atribusi pihak ketiga
Atribusi ke penyedia pihak ketiga diberikan sebagai objek NSAttributedString yang
berisi konten dan link yang harus Anda pertahankan dan tampilkan kepada pengguna.
Cara yang direkomendasikan untuk menampilkan atribusi adalah dengan UITextView, karena link dalam atribusi harus berfungsi.
Untuk memastikan link berfungsi, tetapkan delegasi di UITextView dan tetapkan metode shouldInteractWithURL
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 Perusahaan Contoh
Pada contoh di atas, rentang teks Example Company dicakup oleh
atribut NSLink.
Pelengkapan otomatis untuk alamat pengguna akhir
Jika pengguna akhir menggunakan fungsi Pelengkapan Otomatis dalam Aplikasi Pelanggan Anda untuk mengetik alamat jalan dan alamat jalan tersebut akan diberikan secara lengkap dan akurat oleh pengguna akhir tersebut tanpa Pelengkapan Otomatis, alamat yang dipilih pengguna akhir tersebut tidak tunduk pada batasan Konten Google Maps dalam Perjanjian Google Maps Platform Anda. Pengecualian ini hanya berlaku untuk alamat yang dipilih oleh pengguna akhir dan hanya untuk transaksi spesifik pengguna akhir tersebut; pengecualian ini tidak berlaku untuk daftar alamat yang disarankan yang disediakan oleh fungsi Pelengkapan Otomatis atau untuk Konten Google Maps lainnya. Pengecualian ini tidak berlaku untuk fungsi pencarian POI atau alamat yang ditawarkan oleh Layanan Google Maps Platform lainnya.

Pada gambar sebelumnya, daftar alamat di sebelah kiri masih tunduk pada batasan Konten Google Maps. Setelah pengguna akhir memilih alamat yang dipilihnya, alamat tersebut tidak tunduk pada batasan Konten Google Maps semata-mata untuk tujuan transaksi yang berlaku bagi pengguna akhir tersebut.