Kontrol dan gestur

Pilih platform: Android iOS JavaScript

Dengan Maps SDK for iOS, Anda dapat menyesuaikan cara pengguna berinteraksi dengan peta Anda, dengan menentukan komponen UI bawaan mana yang akan muncul pada peta dan gestur mana yang diizinkan.

Kontrol peta

Maps SDK for iOS menyediakan beberapa kontrol UI bawaan yang mirip dengan yang ada di aplikasi Google Maps untuk iOS. Anda dapat aktifkan/nonaktifkan visibilitas kontrol ini menggunakan class GMSUISettings. Perubahan yang dilakukan pada class ini segera diterapkan pada peta.

Kompas

Maps SDK for iOS menyediakan gambar kompas yang muncul di pojok kanan atas peta dalam keadaan tertentu. Kompas hanya akan muncul saat kamera diorientasikan sedemikian rupa sehingga memiliki arah bukan nol. Jika pengguna mengklik kompas, kamera kembali ke posisi dengan bearing nol (orientasi default) dan kompas memudar tak lama kemudian.

Kompas ini secara default dinonaktifkan. Anda dapat mengaktifkan kompas dengan menetapkan properti compassButton dari GMSUISettings ke YES. Namun, Anda tidak dapat memaksa kompas untuk selalu ditampilkan.

Swift

let camera = GMSCameraPosition(latitude: 37.757815, longitude: -122.50764, zoom: 12)
let mapView = GMSMapView(frame: .zero, camera: camera)
mapView.settings.compassButton = true
      

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:37.757815
                                                        longitude:-122.50764
                                                             zoom:12];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
mapView.settings.compassButton = YES;
      

Tombol Lokasiku

Tombol Lokasiku hanya muncul di pojok kanan bawah layar saat tombol Lokasiku diaktifkan. Saat pengguna mengeklik tombol, kamera dianimasikan untuk fokus pada lokasi pengguna saat ini jika lokasi pengguna diketahui saat ini. Anda dapat mengaktifkan tombol dengan menetapkan properti myLocationButton dari GMSUISettings ke YES.

Swift

mapView.settings.myLocationButton = true
      

Objective-C

mapView.settings.myLocationButton = YES;
      

Pemilih lantai

Kontrol alat pilih lantai muncul di dekat bagian kanan bawah layar setiap kali peta lantai ditampilkan dengan jelas. Jika dua peta lantai atau lebih terlihat pemilih lantai berkaitan dengan bangunan yang paling dekat dengan bagian tengah layar. Masing-masing bangunan memiliki lantai default yang dipilih saat pemilih pertama ditampilkan. Anda bisa memilih lantai yang berbeda dengan memilihnya dari picker.

Anda dapat menonaktifkan kontrol alat pilih lantai dengan menetapkan properti indoorPicker dari GMSUISettings hingga NO.

Swift

mapView.settings.indoorPicker = false
      

Objective-C

mapView.settings.indoorPicker = NO;
      

Gestur peta

Anda dapat menonaktifkan {i>gesture <i}default pada peta dengan mengatur properti Class GMSUISettings, yang tersedia sebagai properti GMSMapView. Isyarat berikut bisa diaktifkan dan dinonaktifkan secara programatis. Perlu diketahui bahwa menonaktifkan gestur tidak akan membatasi akses terprogram ke kamera setelan.

  • scrollGestures — mengontrol apakah gestur scroll diaktifkan atau dinonaktifkan. Jika diaktifkan, pengguna bisa gesek jari untuk menggeser kamera.
  • zoomGestures — mengontrol apakah gestur zoom diaktifkan atau tidak atau dinonaktifkan. Jika diaktifkan, pengguna dapat mengetuk dua kali, mengetuk dengan dua jari, atau mencubit untuk melakukan zoom pada kamera. Perhatikan bahwa mengetuk dua kali atau mencubit saat scrollGestures diaktifkan dapat menggeser kamera ke titik yang ditentukan.
  • tiltGestures — mengontrol apakah gestur kemiringan diaktifkan atau dinonaktifkan. Jika diaktifkan, pengguna dapat menggunakan geser dua jari vertikal ke bawah atau ke atas untuk memiringkan kamera.
  • rotateGestures — mengontrol apakah gestur putar diaktifkan atau dinonaktifkan. Jika diaktifkan, pengguna dapat menggunakan gestur putar dengan dua jari untuk memutar kamera.

Dalam contoh di bawah ini, isyarat geser dan zoom telah dinonaktifkan.

Swift

override func loadView() {
  let camera = GMSCameraPosition.camera(
    withLatitude: 1.285,
    longitude: 103.848,
    zoom: 12
  )

  let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
  mapView.settings.scrollGestures = false
  mapView.settings.zoomGestures = false
  self.view = mapView
}
      

Objective-C

- (void)loadView {
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:1.285
                                                          longitude:103.848
                                                               zoom:12];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  mapView.settings.scrollGestures = NO;
  mapView.settings.zoomGestures = NO;
  self.view = mapView;
}