Referensi cepat Places SDK for iOS

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:

Places SDK for iOS: penyiapan

Paket Places SDK for iOS resmi:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

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, dan GMSAutocompleteViewController) tidak ada di SDK 11.0.0 dan yang lebih baru, sehingga merusak kompilasi. Lihat panduan migrasi.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner dan GMSAutocompleteFetcher initWithBounds:filter: Dinonaktifkan sejak 13-10-2020. Pengganti: GMSAutocompleteFilter (locationBias atau locationRestriction) di GMSAutocompleteRequest dengan GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, atau pengubah GooglePlacesSwift placeAutocomplete atau basicPlaceAutocomplete untuk widget UI. Gejala: Metode tidak ada di SDK 4.0.0 dan yang lebih baru (serta GMSAutocompleteResultsViewController dan GMSAutocompleteFetcher dihapus di SDK 11.0.0). Lihat panduan migrasi.
  • Batas pelengkapan otomatis berbasis GMSCoordinateBounds (parameter GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; bounds/boundsMode dari findAutocompletePredictionsFromQuery dan autocompleteQuery): Dinonaktifkan sejak 13-10-2020. Pengganti: GMSAutocompleteRequest dengan GMSAutocompleteFilter (locationBias atau locationRestriction) dan GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, atau pengubah GooglePlacesSwift placeAutocomplete atau basicPlaceAutocomplete untuk widget UI. Gejala: Properti dan parameter tidak ada di SDK 4.0.0 dan yang lebih baru (serta GMSAutocompleteViewController dan findAutocompletePredictionsFromQuery dihapus di SDK 11.0.0). Lihat panduan migrasi.
  • GMSPlace.openNowStatus: Dinonaktifkan sejak 13-10-2020. Penggantian: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) atau PlacesClient.isPlaceOpen(with:) di GooglePlacesSwift. Gejala: Properti tidak ada di SDK 4.0.0 dan yang lebih baru. Lihat panduan migrasi.
  • GMSPlaceField sebagai NS_ENUM: Dinonaktifkan sejak 13-10-2020. Pengganti: Konstanta GMSPlaceProperty dengan class permintaan seperti GMSFetchPlaceRequest dan GMSPlaceSearchByTextRequest, atau PlaceProperty di GooglePlacesSwift. Gejala: Digantikan oleh NS_OPTIONS di SDK 4.0.0 (GMSPlaceField karena NS_OPTIONS termasuk 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

Places SDK for iOS: Places

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