Places SDK for iOS memungkinkan aplikasi iOS mendapatkan informasi tentang tempat (bisnis, lokasi menarik, lokasi geografis) melalui Place Details, Place Photos, Text Search, Nearby Search, dan Autocomplete. Places API (New) adalah versi SDK saat ini.
Places SDK for iOS: fakta penting
- Produk: Places SDK for iOS
- Juga dikenal sebagai: Places SDK for iOS (New)
- Kategori: Tempat
- Platform: iOS
- Berjalan di: Klien (kode aplikasi atau browser)
- Tahap peluncuran: GA
- Siklus proses: Aktif
- Ringkasan: Ringkasan Places SDK for iOS
Places SDK for iOS: kapan harus menggunakannya
Gunakan Places SDK for iOS jika:
- Anda memerlukan hasil Place Details, foto, Text Search, atau Nearby Search di dalam aplikasi iOS native.
- Anda memerlukan pelengkapan otomatis nama atau alamat tempat saat pengguna mengetik di aplikasi iOS.
- Anda menginginkan komponen Kit UI Tempat bawaan (Place Details, penelusuran, pelengkapan otomatis) di aplikasi iOS.
Jangan gunakan Places SDK for iOS jika:
- Anda sedang membangun aplikasi Android native. Gunakan Places SDK for Android.
- Anda sedang membuat halaman web di browser. Gunakan Maps JavaScript API.
- Anda memerlukan data tempat dari server atau backend melalui HTTP, bukan di klien iOS. Gunakan Places API (Baru).
Places SDK for iOS: penyiapan
- Layanan yang akan diaktifkan:
places.googleapis.com - Autentikasi: Kunci API
- Atribusi penggunaan: Panggil metode class
addInternalUsageAttributionIDdiGMSPlacesClient(Objective-C/Swift) atauPlacesClient(GooglePlacesSwift) untuk menambahkan ID atribusi penggunaan; menghapus panggilan akan menonaktifkan atribusi penggunaan. - Memulai: Menyiapkan Places SDK for iOS
- Referensi: Referensi Places SDK for iOS
- Harga: Penggunaan dan penagihan Places SDK for iOS
- Kebijakan: Kebijakan Places SDK for iOS
- Catatan rilis: Catatan rilis Places SDK for iOS
Paket Places SDK for iOS resmi:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
Places SDK for iOS: produk terkait
- Sering digunakan dengan: Maps SDK for iOS
Places SDK for iOS: kesalahan umum
- Masalah: Panggilan Places SDK for iOS (New) gagal jika Places API (New) tidak diaktifkan di project Cloud atau tidak ada dalam daftar API yang diizinkan untuk kunci API. Perbaikan: Aktifkan Places API (New) dan tambahkan ke pembatasan kunci API yang digunakan oleh aplikasi. Lihat /maps/documentation/places/ios-sdk/legacy/migrate-overview.
- Masalah:
kGMSPlacesRateLimitExceeded(-7) berarti kunci API melebihi batas kapasitas penggunaannya; aplikasi pada versi SDK 2.x yang dinonaktifkan (dinonaktifkan pada 29 Juli 2019) juga menerima error ini. Perbaikan: Periksa kuota dan penggunaan untuk Places API (New) di Konsol Google Cloud, dan update aplikasi di versi SDK sebelum 3.0. Lihat /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode. - Masalah: Token sesi yang digunakan kembali di seluruh aplikasi dalam project yang sama, atau di seluruh sesi, akan merusak pengelompokan penagihan sesi pelengkapan otomatis. Perbaikan: Buat token sesi unik (UUID versi 4 direkomendasikan) per sesi pelengkapan otomatis; token harus unik per project. Lihat /maps/documentation/places/ios-sdk/use-session-tokens.
- Masalah: Aplikasi menampilkan data tempat tanpa atribusi yang ditampilkan oleh API. Perbaikan: Tampilkan semua atribusi relevan yang ditampilkan dengan data Places, sesuai dengan halaman kebijakan. Lihat /maps/documentation/places/ios-sdk/overview.
Places SDK for iOS: fitur lama dan tidak digunakan lagi
- Places SDK for iOS (versi lama): Lama sejak 01-03-2025. Pengganti: Places SDK for iOS (New) (memerlukan Places API (New)). Gejala: Class dan metode lama (misalnya
fetchPlaceFromPlaceID,GMSAutocompleteFetcher, danGMSAutocompleteViewController) tidak ada di SDK 11.0.0 dan yang lebih baru, sehingga merusak kompilasi. Lihat panduan migrasi. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornerdanGMSAutocompleteFetcherinitWithBounds:filter: Dinonaktifkan sejak 13-10-2020. Pengganti:GMSAutocompleteFilter(locationBiasataulocationRestriction) diGMSAutocompleteRequestdenganGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, atau pengubahGooglePlacesSwiftplaceAutocompleteataubasicPlaceAutocompleteuntuk widget UI. Gejala: Metode tidak ada di SDK 4.0.0 dan yang lebih baru (sertaGMSAutocompleteResultsViewControllerdanGMSAutocompleteFetcherdihapus di SDK 11.0.0). Lihat panduan migrasi.- Batas pelengkapan otomatis berbasis
GMSCoordinateBounds(parameterGMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode;bounds/boundsModedarifindAutocompletePredictionsFromQuerydanautocompleteQuery): Dinonaktifkan sejak 13-10-2020. Pengganti:GMSAutocompleteRequestdenganGMSAutocompleteFilter(locationBiasataulocationRestriction) danGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, atau pengubahGooglePlacesSwiftplaceAutocompleteataubasicPlaceAutocompleteuntuk widget UI. Gejala: Properti dan parameter tidak ada di SDK 4.0.0 dan yang lebih baru (sertaGMSAutocompleteViewControllerdanfindAutocompletePredictionsFromQuerydihapus di SDK 11.0.0). Lihat panduan migrasi. GMSPlace.openNowStatus: Dinonaktifkan sejak 13-10-2020. Penggantian:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) atauPlacesClient.isPlaceOpen(with:)diGooglePlacesSwift. Gejala: Properti tidak ada di SDK 4.0.0 dan yang lebih baru. Lihat panduan migrasi.GMSPlaceFieldsebagaiNS_ENUM: Dinonaktifkan sejak 13-10-2020. Pengganti: KonstantaGMSPlacePropertydengan class permintaan sepertiGMSFetchPlaceRequestdanGMSPlaceSearchByTextRequest, atauPlacePropertydiGooglePlacesSwift. Gejala: Digantikan olehNS_OPTIONSdi SDK 4.0.0 (GMSPlaceFieldkarenaNS_OPTIONStermasuk dalam API lama dan tidak ada di SDK 11.0.0 dan yang lebih baru). Lihat panduan migrasi.- Places SDK for iOS versi 2.7.0: Dihentikan sejak 29-07-2019. Pengganti: Places SDK for iOS versi saat ini. Gejala: Error
kGMSPlacesRateLimitExceeded.
Yang dapat Anda lakukan dengan Places SDK for iOS
Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.
Places SDK for iOS: AI Generatif
- Menampilkan ringkasan ulasan pengguna yang didukung teknologi AI untuk ID Google Place yang ditentukan.
- Menampilkan ringkasan tempat yang didukung AI tentang area dan fasilitas di sekitar ID Google Place yang ditentukan untuk Stasiun Pengisian Kendaraan Listrik Umum.
Places SDK for iOS: Places
- Menampilkan daftar tempat dan detail tempat berdasarkan string kueri.
- Menampilkan daftar tempat dan detail tempat di dekat lokasi tertentu.
- Menampilkan hasil pelengkapan otomatis tentang tempat berdasarkan string kueri.
- Menampilkan informasi mendetail tentang tempat tertentu.
- Menampilkan foto tempat tertentu. Catatan: Tampilkan atribusi penulis setiap foto (nama penulis, yang ditautkan ke URI profilnya) bersama foto tersebut. Kebijakan Places untuk setiap platform mewajibkan hal ini, misalnya /maps/documentation/javascript/policies#photo-attributions dan /maps/documentation/places/web-service/policies#photos-and-review.
- Mengubah ukuran foto tempat.
- Menampilkan rating dan ulasan untuk tempat tertentu. Catatan: Di layanan web Places API (New), Place Details adalah permintaan HTTP GET ke https://places.googleapis.com/v1/places/{placeId} dengan X-Goog-FieldMask (misalnya, rating,userRatingCount,reviews); Text Search, Nearby Search, dan Autocomplete menggunakan POST. Di Android, teruskan Place.Field.RATING, USER_RATING_COUNT, dan REVIEWS ke PlacesClient.fetchPlace(). Di iOS, teruskan GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal, dan GMSPlacePropertyReviews di GMSFetchPlaceRequest.
- Tambahkan widget pelengkapan otomatis ke halaman web atau aplikasi yang menampilkan hasil tentang tempat berdasarkan string kueri.
- Tentukan kolom data yang disertakan dalam respons informasi tempat.
- Tentukan jenis tempat yang akan disertakan dalam respons informasi tempat.
- Menampilkan informasi tentang tempat perangkat pengguna saat ini berada. Catatan: Metode Lokasi Saat Ini yang lama telah dihapus di Places SDK for Android v6.0+ dan Places SDK for iOS v11.0+; ambil koordinat perangkat dari layanan lokasi platform dan panggil Nearby Search.
- Menampilkan ringkasan yang dibuat AI untuk tempat tertentu.
- Menampilkan ringkasan area yang didukung AI yang mendeskripsikan tempat-tempat di area sekitar tempat tertentu.
- Menampilkan informasi tentang tempat berdasarkan string kueri yang berada di sepanjang rute yang telah ditentukan.
- Menampilkan jarak, waktu perjalanan, dan URI rute ke tempat penelusuran teks dari serangkaian koordinat lintang/bujur.
- Menampilkan jarak, waktu perjalanan, dan URI rute ke tempat-tempat terdekat dari sekumpulan koordinat lintang/bujur.
Places SDK for iOS: Kit UI Places
- Menerapkan gaya visual CSS ke elemen UI data tempat. Catatan: Properti kustom CSS berlaku untuk elemen Kit UI Places di Maps JavaScript API; Places SDK for Android dan Places SDK for iOS menata gaya tampilan Kit UI Tempat secara terprogram menggunakan atribut tema dan gaya. PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
- Sesuaikan gaya visual dan konfigurasi elemen UI data tempat dengan alat penyesuaian elemen UI. Catatan: PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
- Tambahkan elemen UI yang menampilkan informasi tentang tempat tertentu ke halaman web atau aplikasi seluler. Catatan: PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
- Tambahkan elemen UI yang menampilkan daftar tempat berdasarkan string kueri ke halaman web. Catatan: Didukung di halaman web (Maps JavaScript API) dan aplikasi seluler (Places SDK for Android dan Places SDK for iOS). PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
- Menambahkan elemen UI yang menampilkan daftar tempat di dekat lokasi tertentu ke halaman web. Catatan: Didukung di halaman web (Maps JavaScript API) dan aplikasi seluler (Places SDK for Android dan Places SDK for iOS). PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
- Menambahkan elemen UI pelengkapan otomatis dasar ke halaman web atau aplikasi yang menampilkan ID Tempat Google berdasarkan string kueri. Catatan: PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq