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

Skema URL Google Maps

Anda bisa menggunakan skema URL Google Maps untuk meluncurkan aplikasi Google Maps untuk iOS dan melakukan penelusuran, mendapatkan permintaan arah, dan memperlihatkan tampilan peta. Bila meluncurkan Google Maps, identifier bundel Anda secara otomatis dikirim sebagai bagian dari permintaan.

Anda tidak membutuhkan kunci Google API untuk menggunakan skema URL Google Maps.

Ringkasan

Skema URL memungkinkan Anda meluncurkan aplikasi asli iOS dari aplikasi iOS lain atau aplikasi web. Anda bisa menyetel opsi dalam URL yang akan diteruskan ke aplikasi yang diluncurkan. Aplikasi Google Maps for iOS mendukung skema URL berikut:

  • comgooglemaps:// dan comgooglemaps-x-callback:// - Skema ini memungkinkan Anda meluncurkan aplikasi Google Maps for iOS dan melakukan salah satu dari beberapa tindakan berikut:

    • Menampilkan peta pada lokasi dan tingkat zoom yang ditetapkan.
    • Menelusuri lokasi atau tempat, dan menampilkannya di peta.
    • Meminta arah dari satu lokasi ke lokasi lain. Arah bisa dikembalikan untuk empat moda transportasi: mengemudi, berjalan kaki, bersepeda dan angkutan umum.
    • Menambahkan navigasi ke aplikasi Anda.
    • Melalui iOS 8, terbitkan callback bila aplikasi telah selesai, menggunakan comgooglemaps-x-callback://. Callback sering digunakan untuk mengembalikan pengguna ke aplikasi yang semula membuka Google Maps for iOS. Perhatikan bahwa pada iOS 9, sistem secara otomatis menyediakan tautan "Back to" di pojok kiri bilah status.
  • comgooglemapsurl:// - Skema ini memungkinkan Anda meluncurkan aplikasi Google Maps for iOS menggunakan URL yang berasal dari situs web Google Maps desktop. Ini berarti Anda bisa memberikan pengguna Anda pengalaman seluler asli daripada hanya memuat situs web Google Maps.

    • URL asal bisa untuk maps.google.com, atau untuk google.com/maps, atau menggunakan domain negara tingkat atas yang valid sebagai ganti com. Anda juga bisa meneruskan URL pengalihan pada goo.gl/maps.
    • Anda bisa menerbitkan callback menggunakan parameter x-source dan x-success dengan skema URL comgooglemapsurl://.

Meluncurkan aplikasi Google Maps for iOS dan melakukan fungsi tertentu

Catatan: Dimulai dengan iOS 9, aplikasi Anda harus menyatakan skema URL yang akan dibuka. Lihat Memulai untuk informasi selengkapnya.

Untuk meluncurkan aplikasi Google Maps for iOS dan secara opsional melakukan salah satu fungsi yang didukung, gunakan skema URL dengan bentuk berikut:

comgooglemaps://?parameters

atau:

comgooglemaps-x-callback://?parameters

Parameter nanti dijelaskan secara detail dalam dokumen ini.

Periksa ketersediaan aplikasi Google Maps pada perangkat

Sebelum menyajikan salah satu URL ini kepada pengguna di aplikasi, Anda terlebih dahulu harus memverifikasi bahwa aplikasi telah dipasang. Aplikasi Anda bisa memeriksa apakah skema URL tersedia dengan kode berikut:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
    [NSURL URLWithString:@"comgooglemaps://"]];

Misalnya, untuk menampilkan peta Central Park di New York, Anda bisa menggunakan kode berikut:

Swift

if (UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)) {
  UIApplication.shared.openURL(URL(string:
    "comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic")!)
} else {
  print("Can't use comgooglemaps://");
}

Objective-C

if ([[UIApplication sharedApplication] canOpenURL:
     [NSURL URLWithString:@"comgooglemaps://"]]) {
  [[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic"]];
} else {
  NSLog(@"Can't use comgooglemaps://");
}

Menampilkan peta

Gunakan skema URL untuk menampilkan peta pada tingkat zoom dan lokasi yang ditetapkan. Anda juga bisa melapiskan tampilan lain di atas peta Anda, atau menampilkan gambar Street View.

Parameter

Semua parameter berikut ini bersifat opsional. Jika tidak ada parameter yang disetel, skema URL hanya akan meluncurkan aplikasi Google Maps for iOS.

  • center: Ini adalah titik pusat tampilan peta yang terlihat. Diformat sebagai string latitude,longitude yang dipisah koma.
  • mapmode: Menyetel jenis peta yang ditampilkan. Bisa disetel ke: standard atau streetview. Jika tidak ditetapkan, setelan aplikasi saat ini akan digunakan.
  • views: Mengaktifkan/menonaktifkan tampilan tertentu. Bisa disetel ke: satellite, traffic, atau transit. Beberapa nilai bisa disetel menggunakan pemisah-koma. Jika parameter ditetapkan tanpa nilai, maka ini akan menghapus semua tampilan.
  • zoom: Menetapkan tingkat zoom pada peta.

Contoh URL di bawah ini, yang menampilkan peta yang berpusat di New York pada tingkat zoom 14 dengan tampilan lalu lintas di:

comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic

Peta lalu lintas New York

Beberapa contoh tambahan di bawah ini:

comgooglemaps://?center=37.788463,-122.392545&zoom=12
comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

Penelusuran

Gunakan skema ini untuk menampilkan kueri penelusuran di lokasi tampilan yang terlihat yang ditetapkan.

Parameter

Selain parameter yang digunakan untuk menampilkan peta, Search mendukung parameter q.

  • q: String kueri untuk penelusuran Anda.

URL contoh di bawah ini akan menelusuri "Pizza" di sekitar lokasi yang ditetapkan:

comgooglemaps://?q=Pizza&center=37.759748,-122.427135

Pizza terdekat

Beberapa contoh tambahan di bawah ini:

comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA&center=37.782652,-122.410126&views=satellite,traffic&zoom=15
comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan&center=35.660888,139.73073&zoom=15&views=transit

Menampilkan arah

Gunakan skema ini untuk meminta dan menampilkan arah di antara dua lokasi. Anda juga bisa menetapkan moda transportasi.

Parameter

  • saddr: Menyetel titik awal untuk penelusuran arah. Ini bisa berupa garis lintang, garis bujur atau alamat berformat kueri. Jika itu adalah string kueri yang mengembalikan lebih dari satu hasil, maka hasil pertama yang akan dipilih. Jika nilainya dibiarkan kosong, maka lokasi pengguna saat ini akan digunakan.
  • daddr: Menyetel titik akhir untuk penelusuran arah. Memiliki format dan perilaku yang sama seperti saddr.
  • directionsmode: Metode transportasi. Bisa disetel ke: driving, transit, bicycling atau walking.

URL contoh di bawah ini menampilkan arah angkutan umum antara Google NYC dan JFK Airport:

comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit

Arah angkutan umum

Beberapa contoh tambahan di bawah ini:

comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA&center=37.422185,-122.083898&zoom=10
comgooglemaps://?saddr=2025+Garcia+Ave,+Mountain+View,+CA,+USA&daddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA,+United+States&center=37.423725,-122.0877&directionsmode=walking&zoom=17

Menetapkan URL callback

Jika ingin menetapkan URL callback, Anda perlu menggunakan skema URL comgooglemaps-x-callback://. Skema ini tunduk pada [x-callback-spesifikasi url]. Bila Anda memanggil aplikasi Google Maps for iOS dengan skema ini, aplikasi akan menampilkan tombol di atas layar. Mengetuk tombol ini akan mengeluarkan callback ke URL yang telah Anda tetapkan.

Permintaan ke comgooglemaps-x-callback:// harus berbentuk:

comgooglemaps-x-callback://?parameters

Parameter

Skema URL x-callback menerima parameter yang sama seperti skema URL comgooglemaps://`, dengan parameter tambahan berikut ini. Kedua parameter diperlukan.

  • x-source — Nama aplikasi yang mengirimkan permintaan x-callback. Nama pendek lebih disukai.
  • x-success — URL yang akan dipanggil bila selesai. Sering kali ini akan menjadi skema URL untuk aplikasi Anda sendiri, yang memungkinkan pengguna kembali ke aplikasi asal.

Perhatikan, aplikasi Anda harus mendaftarkan skema URL-nya sendiri agar bisa merespons URL callback.

  1. Pastikan aplikasi Anda telah mendaftarkan skema URL agar bisa merespons permintaan callback.
  2. Teruskan label untuk tombol callback dalam parameter x-source.
  3. Teruskan URL callback dalam parameter x-success.

Contoh berikut akan meluncurkan aplikasi Google Maps for iOS dan menampilkan peta yang berpusat di New York. Aplikasi ini juga akan menampilkan tombol berlabel "SourceApp". Bila tombol "SourceApp" diklik, aplikasi Google Maps for iOS akan mengeluarkan callback ke skema URL fiktif, sourceapp://?resume=true.

comgooglemaps-x-callback://?center=40.765819,-73.975866&zoom=14
   &x-success=sourceapp://?resume=true
   &x-source=SourceApp

Seperti pada skema URL comgooglemaps://, Anda harus terlebih dahulu memverifikasi apakah aplikasi Google Maps for iOS tersedia pada perangkat, dan mendukung skema URL x-callback. Aplikasi Anda bisa memeriksa apakah skema URL tersedia dengan kode berikut:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemaps-x-callback://"]];

Contoh URL yang memungkinkan pengguna kembali ke aplikasi setelah menelusuri dessert ditampilkan di bawah ini.

comgooglemaps-x-callback://?q=dessert&center=37.759748,-122.427135
   &x-success=sourceapp://?resume=true
   &x-source=Nom+Nom

Menambahkan navigasi ke aplikasi Anda

Meluncurkan aplikasi Google Maps for iOS bersama permintaan arah adalah cara mudah dalam memberikan akses navigasi belokan-per-belokan untuk pengguna aplikasi Anda. Anda bisa menggunakan skema URL comgooglemaps:// atau comgooglemaps-x-callback://.

Catatan: Tombol yang ditambahkan melalui parameter x-source tidak akan ditampilkan dalam UI navigasi belokan-demi-belokan.

Cuplikan kode di bawah ini menampilkan cara menggunakan skema comgooglemaps-x-callback://` untuk permintaan arah, kemudian kembali ke aplikasi Anda bila pengguna sudah siap. Kode akan melakukan yang berikut ini:

  1. Memverifikasi apakah skema URL comgooglemaps-x-callback:// telah tersedia.
  2. Meluncurkan aplikasi Google Maps for iOS dan meminta arah ke JFK Airport di kota New York. Biarkan alamat awal kosong untuk meminta arah dari lokasi pengguna saat ini.
  3. Menambahkan tombol berlabel "AirApp" ke aplikasi Google Maps for iOS. Label tombol didefinisikan melalui parameter x-source.
  4. Memanggil skema URL fiktif, sourceapp://, bila pengguna mengeklik tombol kembali.

Kodenya ditampilkan di bawah ini.

Swift

let testURL = URL(string: "comgooglemaps-x-callback://")!
if UIApplication.shared.canOpenURL(testURL) {
  let directionsRequest = "comgooglemaps-x-callback://" +
    "?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
    "&x-success=sourceapp://?resume=true&x-source=AirApp"

  let directionsURL = URL(string: directionsRequest)!
  UIApplication.shared.openURL(directionsURL)
} else {
  NSLog("Can't use comgooglemaps-x-callback:// on this device.")
}

Objective-C

NSURL *testURL = [NSURL URLWithString:@"comgooglemaps-x-callback://"];
if ([[UIApplication sharedApplication] canOpenURL:testURL]) {
  NSString *directionsRequest = @"comgooglemaps-x-callback://" +
      @"?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
      @"&x-success=sourceapp://?resume=true&x-source=AirApp";
  NSURL *directionsURL = [NSURL URLWithString:directionsRequest];
  [[UIApplication sharedApplication] openURL:directionsURL];
} else {
  NSLog(@"Can't use comgooglemaps-x-callback:// on this device.");
}

Meluncurkan aplikasi Google Maps for iOS dari URL dekstop Google Maps

Jika aplikasi Anda memiliki akses ke URL Google Maps yang sudah ada, seperti pada laman web atau dalam database, Anda bisa menggunakan skema di bawah ini untuk membuka URL di aplikasi Google Maps for iOS, sehingga menawarkan pengalaman asli terbaik kepada pengguna Anda.

  1. Ganti skema http:// atau https:// dengan comgooglemapsurl://.
  2. Jika Anda ingin menggunakan callback, sertakan parameter x-source dan x-success. Skema ini tunduk pada [x-callback-spesifikasi url].

Format URL Google Maps yang didukung

Skema comgooglemapsurl:// mendukung URL yang cocok dengan ekspresi reguler berikut ini, dengan {TLD} mengacu ke setiap domain negara tingkat atas yang valid. Ganti-baris ditambahkan agar jelas:

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Periksa ketersediaan aplikasi Google Maps

Terlebih dahulu verifikasi apak aplikasi Google Maps for iOS tersedia pada perangkat, dan mendukung skema URL:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemapsurl://"]];

Contoh

Contoh URL Google Maps generik:

URL Google Maps Asal:

https://www.google.com/maps/preview/@42.585444,13.007813,6z

Menggunakan skema URL:

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

Contoh URL Google Maps generik:

URL Google Maps Asal:

https://maps.google.com/?q=@37.3161,-122.1836

Menggunakan skema URL:

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836

Misalnya meminta arah ke Tokyo Tower dengan x-callback:

URL Google Maps Asal:

http://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1

Contoh berikut akan meluncurkan aplikasi Google Maps for iOS dan menampilkan peta bersama arah ke Tokyo Tower, sebagaimana ditetapkan dalam URL Google Maps asal (di atas). Aplikasi juga akan menampilkan tombol berlabel "SourceApp". Bila tombol "SourceApp" diklik, aplikasi Google Maps for iOS akan mengeluarkan callback ke skema URL fiktif, sourceapp://?resume=true.

comgooglemapsurl://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1
    &x-source=SourceApp
    &x-success=sourceapp://?resume=true

Kirim masukan tentang...

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