Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Maps SDK for iOS

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Maps SDK for iOS
  3. Buat kunci yang sesuai
Lanjutkan

Overlay Bumi

Overlay bumi adalah lapisan pada peta yang terikat dengan koordinat garis lintang/garis bujur, sehingga ikut bergerak bila Anda menyeret atau melakukan zoom pada peta.

Pengantar

Overlay bumi adalah gambar yang dilekatkan pada peta. Berbeda dengan marker, overlay bumi berorientasi terhadap permukaan bumi bukan pada layar, sehingga memutar, memiringkan atau melakukan zooming pada peta akan mengubah orientasi gambar.

Untuk menambahkan overlay bumi, buat sebuah objek GMSGroundOverlay yang mendefinisikan ikon dan batas-batas. Tidak menetapkan keduanya akan menyebabkan overlay bumi tidak muncul pada peta. Anda juga bisa menetapkan setelan tambahan yang akan memengaruhi pemosisian gambar pada peta. Setelah Anda mendefinisikan opsi yang diperlukan, setel properti objek map untuk menambahkan overlay.

Menambahkan overlay

  1. Buat instance objek GMSGroundOverlay
  2. Setel properti icon ke instance UIImage.
  3. Setel properti bounds ke instance GMSCoordinateBounds. Batas-batas tersebut menyatakan sudut barat daya dan timur laut gambar.
  4. Setel properti opsional, seperti bearing dan zoomLevel, sesuai keinginan.
  5. Setel properti map - gambar akan muncul pada peta.

Contoh di bawah ini memperagakan cara menambahkan overlay bumi ke objek GMSMapView yang ada.

Swift

let southWest = CLLocationCoordinate2D(latitude: 40.712216, longitude: -74.22655)
let northEast = CLLocationCoordinate2D(latitude: 40.773941, longitude: -74.12544)
let overlayBounds = GMSCoordinateBounds(coordinate: southWest, coordinate: northEast)

// Image from http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg
let icon = UIImage(named: "newark_nj_1922")

let overlay = GMSGroundOverlay(bounds: overlayBounds, icon: icon)
overlay.bearing = 0
overlay.map = mapView

Objective-C

CLLocationCoordinate2D southWest = CLLocationCoordinate2DMake(40.712216,-74.22655);
CLLocationCoordinate2D northEast = CLLocationCoordinate2DMake(40.773941,-74.12544);
GMSCoordinateBounds *overlayBounds = [[GMSCoordinateBounds alloc] initWithCoordinate:southWest
                                                                        coordinate:northEast];

// Image from http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg
UIImage *icon = [UIImage imageNamed:@"newark_nj_1922"];
GMSGroundOverlay *overlay =
    [GMSGroundOverlay groundOverlayWithBounds:overlayBounds icon:icon];
overlay.bearing = 0;
overlay.map = mapView;

Membuang overlay

Anda bisa membuang overlay bumi dari peta dengan menyetel properti map ke nil pada GMSGroundOverlay. Sebagai alternatif, Anda bisa membuang semua overlay (termasuk overlay bumi saat ini di peta dengan memanggil metode GMSMapView clear.

Swift

let camera = GMSCameraPosition.camera(withLatitude: 40.71,
                                      longitude: -74.22,
                                      zoom:11)
let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
...
mapView.clear()

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:40.742
                                                        longitude:-74.174
                                                             zoom:6];
mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
...
[mapView clear];

Jika Anda ingin memodifikasi overlay bumi setelah menambahkannya ke peta, pastikan Anda tetap menyimpan objek GMSGroundOverlay. Anda bisa memodifikasi overlay bumi tersebut nanti dengan membuat perubahan pada objek ini.

Swift

let overlay = GMSGroundOverlay(position: newark, icon: icon, zoomLevel: 10)
overlay.map = mapView
...
overlay.isTappable = true

Objective-C

GMSGroundOverlay *overlay =
    [GMSGroundOverlay groundOverlayWithPosition:newark
                                           icon:icon
                                      zoomLevel:10];
overlay.map = mapView;
...
overlay.tappable = YES;

Kejadian

Anda bisa memantau kejadian yang terjadi pada peta, seperti saat pengguna mengetuk overlay. Untuk memantau kejadian, Anda harus mengimplementasikan protokol GMSMapViewDelegate. Lihat panduan kejadian dan daftar metode pada GMSMapViewDelegate.

Kirim masukan tentang...

Google Maps SDK for iOS
Google Maps SDK for iOS
Butuh bantuan? Kunjungi halaman dukungan kami.