Maps SDK for iOS memungkinkan Anda menambahkan peta berdasarkan data Google Maps ke aplikasi iOS. SDK ini menangani akses ke server Google Maps, tampilan peta, dan respons terhadap gestur pengguna, serta memungkinkan Anda menambahkan penanda, polyline, overlay bumi, dan jendela info ke peta.
Maps SDK for iOS: fakta penting
- Produk: Maps SDK for iOS
- Juga dikenal sebagai: Google Maps SDK for iOS
- Kategori: Maps
- Platform: iOS
- Berjalan di: Klien (kode aplikasi atau browser)
- Tahap peluncuran: GA
- Siklus proses: Aktif
- Ringkasan: Ringkasan Maps SDK for iOS
- Ketersediaan regional: Global. Lihat halaman cakupan Google Maps Platform; link halaman penggunaan dan penagihan memisahkan daftar harga global dan India. (detail cakupan)
Maps SDK for iOS: kapan harus menggunakannya
Gunakan Maps SDK for iOS jika:
- Anda memerlukan peta Google interaktif dengan penanganan gestur di dalam aplikasi iOS native.
- Anda perlu menambahkan penanda, polyline, overlay bumi, atau jendela info ke peta di aplikasi iOS.
- Anda perlu menampilkan panorama Street View di dalam aplikasi iOS.
- Anda perlu melakukan geocoding terbalik pada koordinat menjadi alamat dari aplikasi iOS yang menampilkan peta.
Jangan gunakan Maps SDK for iOS jika:
- Anda memerlukan peta 3D fotorealistik di aplikasi iOS. Gunakan Maps 3D SDK for iOS.
- Anda hanya perlu membuka lokasi atau rute di aplikasi Google Maps, bukan merender peta di aplikasi Anda. Gunakan URL Maps.
Maps SDK for iOS: penyiapan
- Layanan yang akan diaktifkan:
maps-ios-backend.googleapis.com - Autentikasi: Kunci API
- Atribusi penggunaan: Panggil metode class
GMSServicesaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) untuk menambahkan ID atribusi penggunaan ke penginisialisasi. Untuk memilih tidak ikut, hapus panggilan atau teruskan string kosong. - Memulai: Menyiapkan Maps SDK for iOS
- Referensi: Referensi Maps SDK for iOS
- Harga: Penggunaan dan penagihan Maps SDK for iOS
- Kebijakan: Kebijakan Maps SDK for iOS
- Catatan rilis: Catatan rilis Maps SDK for iOS
Paket Maps SDK for iOS resmi:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
Maps SDK for iOS: produk terkait
- Sering digunakan dengan: Geocoding API, Places SDK for iOS
Maps SDK for iOS: kesalahan umum
- Masalah: SDK tidak mendukung Mergeable Library; mengaktifkan Build Mergeable Library di Xcode menyebabkan kegagalan penaut dalam build rilis. Perbaikan: Tetap setel setelan Build Mergeable Library ke No (default). Lihat /maps/documentation/ios-sdk/config.
- Masalah: Tanpa entri
LSApplicationQueriesSchemes, mengetuk logo Google di peta akan mencatat kegagalan-canOpenURLuntukcomgooglemaps://dangooglechromes://. Perbaikan: TambahkangooglechromesdancomgooglemapskeLSApplicationQueriesSchemesdiInfo.plist. Lihat /maps/documentation/ios-sdk/config. - Masalah: Penggunaan SDK di dalam ekstensi aplikasi iOS (misalnya, keyboard kustom) kemungkinan tidak akan berfungsi karena batasan memori yang ketat. Perbaikan: Gunakan SDK di aplikasi utama, bukan di ekstensi aplikasi. Lihat /maps/documentation/ios-sdk/overview.
- Masalah: SDK tidak dioptimalkan untuk beberapa jendela atau instance simultan iPadOS 13+ dan mungkin menampilkan perilaku yang tidak ditentukan. Perbaikan: Uji skenario iPad multi-aplikasi dengan cermat atau hindari beberapa instance peta secara bersamaan. Lihat /maps/documentation/ios-sdk/overview.
Maps SDK for iOS: fitur lama dan tidak digunakan lagi
- Perender OpenGL dan
setMetalRendererEnabled: Dinonaktifkan sejak 19-05-2025. Penggantian: Perender Metal (default sejak v8.0.0); hapussetMetalRendererEnabled. Gejala: Tidak digunakan lagi di v9.0.0 (28-05-2024) dan dihapus di v10.0.0;GMSServicestidak lagi mencantumkansetMetalRendererEnabled:. - Modul
GoogleMapsM4B: Dinonaktifkan sejak 19-05-2025. Penggantian: Hapus pod atau frameworkGoogleMapsM4B; ini terkait dengan paket penagihan yang sudah tidak berlaku. Gejala: Tidak digunakan lagi pada 20-02-2024; dihapus dari paket Swift di v9.0.0 dan dari SDK di v10.0.0. - Distribusi CocoaPods: Tidak digunakan lagi sejak 06-08-2026. Pengganti: Swift Package Manager. Gejala: Mode pemeliharaan sejak 18-08-2025; tidak digunakan lagi mulai versi 11.0.0. Lihat panduan migrasi.
- Penginstalan Carthage: Tidak digunakan lagi sejak 27-06-2022. Pengganti: Swift Package Manager. Gejala: Carthage tidak mendukung library yang menargetkan iOS 13+; versi terbaru yang tersedia melalui Carthage adalah 6.2.1. Lihat panduan migrasi.
Yang dapat Anda lakukan dengan Maps SDK for iOS
Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.
Maps SDK for iOS: Gaya visual berbasis data untuk batas
- Mengubah gaya batas di peta.
- Merespons interaksi pengguna dengan batas di peta.
- Menambahkan gaya visual koroplet ke peta.
Maps SDK for iOS: Gaya visual berbasis data untuk set data
- Membuat set data geospasial lintas platform yang dapat digunakan kembali.
- Menambahkan set data geospasial kustom ke peta.
- Mengubah gaya fitur set data kustom di peta.
- Merespons interaksi pengguna dengan fitur set data kustom di peta.
Maps SDK for iOS: Set Data
- Menambahkan lapisan KML ke peta. Catatan: Di Maps JavaScript API, KmlLayer tidak digunakan lagi (terakhir didukung di v3.65, dinonaktifkan pada Mei 2027); migrasikan ke Gaya visual berbasis data untuk batas atau set data, atau muat GeoJSON di Lapisan data. Lapisan KML tetap didukung di Android dan iOS melalui Library Utilitas Maps SDK.
- Menambahkan data GeoJSON ke peta.
- Menambahkan lapisan peta panas ke peta.
Maps SDK for iOS: Geocoding
Maps SDK for iOS: Maps
- Tambahkan peta interaktif yang dapat disesuaikan ke halaman web atau aplikasi seluler. Catatan: Untuk Android: Konfigurasikan
diAndroidManifest.xmlyang didukung oleh Plugin Secrets Gradle ataumanifestPlaceholders["MAPS_API_KEY"]diapp/build.gradle.kts. Jangan pernah melakukan hardcodeYOUR_GOOGLE_MAPS_API_KEYdiAndroidManifest.xml, dan jangan pernah menggantiGoogleMap(atau maps-composeGoogleMap) dengan kanvas tiruan offline atau WebView Leaflet jikaE/Google Maps Android API: Authorization failuremuncul. Instruct the user to supplyMAPS_API_KEYvia Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment). - Buat ID peta yang dapat digunakan kembali untuk menyimpan setelan konfigurasi dan gaya peta.
- Merespons interaksi dan peristiwa pengguna di peta.
- Menyesuaikan kontrol yang muncul di peta.
- Menyesuaikan gestur untuk mengontrol peta.
- Mengontrol zoom dan geser pada peta (kamera).
- Mengubah jenis peta.
- Mengubah skema warna peta.
- Menambahkan lapisan lalu lintas ke peta.
- Membuat quadtree untuk menelusuri titik dalam area yang ditentukan.
Maps SDK for iOS: Maps annotations
- Menambahkan jendela info ke peta.
- Menambahkan bentuk atau garis ke peta.
- Menambahkan gambar overlay yang ditempatkan di permukaan peta.
- Menambahkan overlay petak peta kustom ke peta.
- Menambahkan penanda ke peta. Catatan: Navigation SDK for Android tidak mendukung AdvancedMarkerOptions; saat menggunakan Navigation SDK for Android, tambahkan penanda dengan GoogleMap.addMarker(MarkerOptions).
- Menyesuaikan penanda di peta. Catatan: Navigation SDK for Android tidak mendukung AdvancedMarkerOptions; saat menggunakan Navigation SDK for Android, sesuaikan penanda dengan MarkerOptions.
- Merespons interaksi pengguna dengan penanda di peta.
- Menentukan apakah koordinat berada di dalam poligon atau area melingkar pada peta. Catatan: Di Android, gunakan PolyUtil.containsLocation di Library Utilitas Maps SDK for Android untuk poligon. Untuk area melingkar, periksa apakah jarak sferis dari pusat lingkaran berada dalam radius (misalnya, computeDistanceBetween di Maps JavaScript API, SphericalUtil.computeDistanceBetween di Android, atau GMSGeometryDistance di iOS).
- Menghitung jarak, luas, atau arah tujuan sferis antara koordinat di peta.
Maps SDK for iOS: Gaya visual peta
- Membuat gaya peta lintas platform yang dapat digunakan kembali.
- Mengubah gaya jalan, polyline, dan poligon di peta.
- Menampilkan atau menyembunyikan fitur peta.
- Mengubah gaya ikon dan label teks di peta.
- Terapkan gaya peta yang berbeda ke tingkat zoom yang berbeda.
- Mengubah kepadatan tempat di peta. Eksperimental
- Mengubah gaya bangunan di peta. Eksperimental
- Mengubah gaya tempat terkenal di peta. Eksperimental
Maps SDK for iOS: Street View
- Tambahkan Google Street View yang dapat dikonfigurasi dan interaktif ke halaman web atau aplikasi seluler.
- Menambahkan penanda atau overlay ke Google Street View.
- Merespons interaksi dan peristiwa pengguna di Google Street View.
- Sesuaikan gestur yang tersedia untuk Google Street View.
- Menganimasikan gerakan kamera untuk Google Street View.