Pengantar
Dengan menggunakan URL Maps, Anda dapat membuat URL lintas platform universal untuk meluncurkan Google Maps dan melakukan penelusuran, mendapatkan rute dan navigasi, serta menampilkan tampilan peta dan gambar panorama. Sintaksis URL sama, apa pun platform yang digunakan.
Anda tidak memerlukan kunci Google API untuk menggunakan URL Maps.
Sintaksis lintas platform universal
Sebagai developer aplikasi Android, aplikasi iOS, atau situs, Anda dapat membuat URL umum yang akan membuka Google Maps dan melakukan tindakan yang diminta, terlepas dari platform yang digunakan saat peta dibuka.
- Di perangkat Android:
- Jika aplikasi Google Maps untuk Android diinstal dan aktif, URL akan meluncurkan Google Maps di aplikasi Maps dan melakukan tindakan yang diminta.
- Jika aplikasi Google Maps tidak diinstal atau dinonaktifkan, URL akan meluncurkan Google Maps di browser dan melakukan tindakan yang diminta.
- Di perangkat iOS:
- Jika aplikasi Google Maps untuk iOS diinstal, URL akan meluncurkan Google Maps di aplikasi Maps dan melakukan tindakan yang diminta.
- Jika aplikasi Google Maps tidak diinstal, URL akan meluncurkan Google Maps di browser dan melakukan tindakan yang diminta.
- Di perangkat lain, URL meluncurkan Google Maps di browser dan melakukan tindakan yang diminta.
Sebaiknya gunakan URL lintas platform untuk meluncurkan Google Maps dari aplikasi atau situs Anda, karena URL universal ini memungkinkan penanganan permintaan peta yang lebih luas, terlepas dari platform yang digunakan. Untuk fitur yang mungkin hanya berfungsi di platform seluler (misalnya, navigasi belokan demi belokan), Anda dapat memilih untuk menggunakan opsi khusus platform untuk Android atau iOS. Lihat dokumentasi berikut:
- Intent Google Maps untuk Android — khususnya untuk meluncurkan aplikasi Google Maps untuk Android
- Skema URL Google Maps untuk iOS — khususnya untuk meluncurkan aplikasi Google Maps untuk iOS
Meluncurkan Google Maps dan melakukan tindakan tertentu
Untuk meluncurkan Google Maps dan secara opsional melakukan salah satu fungsi yang didukung, gunakan skema URL dari salah satu formulir berikut, bergantung pada tindakan yang diminta:
- Penelusuran
— meluncurkan Google Maps yang menampilkan pin untuk tempat tertentu, atau menjalankan
penelusuran umum dan meluncurkan peta untuk menampilkan hasilnya:
https://www.google.com/maps/search/?api=1¶meters
- Rute
— minta rute dan luncurkan Google Maps dengan hasil:
https://www.google.com/maps/dir/?api=1¶meters
- Menampilkan peta — luncurkan Google Maps tanpa penanda atau rute:
https://www.google.com/maps/@?api=1&map_action=map¶meters
- Menampilkan panorama Street View — luncurkan gambar panorama interaktif:
https://www.google.com/maps/@?api=1&map_action=pano¶meters
Penting: Parameter api=1
mengidentifikasi versi
URL Maps yang ditujukan untuk URL ini. Parameter ini diperlukan dalam setiap
permintaan. Satu-satunya nilai yang valid adalah 1. Jika api=1
TIDAK ada dalam URL,
semua parameter akan diabaikan dan aplikasi Google Maps default akan diluncurkan, baik
di browser atau aplikasi seluler Google Maps, bergantung pada platform yang digunakan
(misalnya https://www.google.com/maps).
Membuat URL yang valid
Anda harus mengenkode URL dengan benar.
Misalnya, beberapa parameter menggunakan karakter pipa
(|
) sebagai pemisah, yang harus Anda enkode sebagai %7C
pada URL final. Parameter lainnya menggunakan nilai yang dipisahkan koma, seperti koordinat lintang/bujur atau Kota, Negara Bagian. Anda harus mengenkode koma sebagai %2C
. Enkode spasi dengan
%20
, atau ganti dengan tanda plus (+
).
Selain itu, URL dibatasi hingga 2.048 karakter untuk setiap permintaan. Perhatikan batas ini saat membuat URL Anda.
Tindakan peta
Tindakan peta yang tersedia adalah: penelusuran, rute, menampilkan peta, dan menampilkan panorama Street View. Anda menentukan tindakan dalam URL permintaan, bersama dengan parameter wajib dan opsional. Sebagaimana standar dalam URL, Anda memisahkan parameter menggunakan karakter ampersand (&
). Untuk setiap tindakan, daftar parameter dan kemungkinan
nilainya disebutkan di bagian Parameter Penelusuran.
Telusuri
Tindakan penelusuran menampilkan hasil untuk penelusuran di seluruh area peta yang terlihat. Saat menelusuri tempat tertentu, peta yang dihasilkan akan menempatkan pin di lokasi yang ditentukan dan menampilkan detail tempat yang tersedia.
Membentuk URL Penelusuran
https://www.google.com/maps/search/?api=1¶meters
Parameter
query
(wajib): Menentukan tempat yang akan disorot di peta. Parameter kueri diperlukan untuk semua permintaan penelusuran.- Tentukan lokasi sebagai nama tempat, alamat, atau koordinat lintang/bujur yang dipisahkan koma. String harus
dienkodekan URL, sehingga alamat
seperti "City Hall, New York, NY" harus dikonversi menjadi
City+Hall%2C+New+York%2C+NY
. - Tentukan istilah penelusuran umum sebagai
string berenkode URL, seperti
grocery+stores
ataurestaurants+in+seattle+wa
.
- Tentukan lokasi sebagai nama tempat, alamat, atau koordinat lintang/bujur yang dipisahkan koma. String harus
dienkodekan URL, sehingga alamat
seperti "City Hall, New York, NY" harus dikonversi menjadi
query_place_id
(opsional): ID tempat adalah ID tekstual yang secara unik mengidentifikasi tempat. Untuk tindakansearch
, Anda harus menentukanquery
, tetapi Anda juga dapat menentukanquery_place_id
. Jika Anda menentukan kedua parameter,query
hanya digunakan jika Google Maps tidak dapat menemukan ID tempat. Jika Anda mencoba menautkan ke tempat tertentu secara definitif, ID tempat adalah jaminan terbaik bahwa Anda akan menautkan ke tempat yang tepat. Sebaiknya Anda juga mengirimkanquery_place_id
saat membuat kueri untuk lokasi tertentu menggunakan koordinat lintang/bujur.
Contoh penelusuran
Penelusuran lokasi
Dalam penelusuran lokasi, Anda menelusuri lokasi tertentu menggunakan nama tempat, alamat, atau koordinat lintang/bujur yang dipisahkan koma, dan peta yang dihasilkan akan menampilkan pin pada lokasi tersebut. Ketiga contoh ini menggambarkan penelusuran untuk lokasi yang sama, CenturyLink Field (stadion olahraga di Seattle, WA), menggunakan nilai lokasi yang berbeda.
Contoh 1: Menelusuri nama tempat "CenturyLink Field" akan menghasilkan peta berikut:
https://www.google.com/maps/search/?api=1&query=centurylink+field
Contoh 2: Menelusuri Kolom CenturyLink menggunakan koordinat lintang/bujur dan ID tempat akan ditampilkan dalam peta berikut:
Contoh 3: Menelusuri Kolom CenturyLink hanya menggunakan hasil koordinat lintang/bujur dalam peta berikut ini. Perhatikan bahwa ada pin dalam peta, tetapi tidak ada informasi tempat tambahan yang diberikan pada peta atau di panel samping:
https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393
Penelusuran kategoris
Dalam penelusuran kategori, Anda meneruskan istilah penelusuran umum, dan Google Maps
akan mencari listingan yang cocok dengan kriteria Anda di dekat lokasi yang ditentukan.
Jika tidak ada lokasi yang ditentukan, Google Maps akan mencoba menemukan listingan di sekitar
lokasi Anda saat ini. Jika Anda memilih untuk memberikan lokasi untuk penelusuran kategori,
sertakan lokasi dalam string penelusuran umum
(misalnya, pizza+seattle+wa
).
Dalam contoh ini, penelusuran untuk restoran pizza di Seattle, WA, menghasilkan peta berikut:
https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa
Petunjuk
Tindakan Directions menampilkan jalur antara dua titik yang ditentukan atau lebih pada peta, serta jarak dan waktu tempuh.
Membentuk URL Rute
https://www.google.com/maps/dir/?api=1¶meters
Parameter
origin
: Menentukan titik awal untuk menampilkan rute. Setelan default-nya adalah lokasi awal yang paling relevan, seperti lokasi perangkat, jika tersedia. Jika tidak ada, peta yang dihasilkan dapat menampilkan formulir kosong yang memungkinkan pengguna memasukkan tempat asal. Nilainya bisa berupa nama tempat, alamat, atau koordinat lintang/bujur yang dipisahkan koma. String harus dienkodekan URL, sehingga alamat seperti "City Hall, New York, NY" harus dikonversi menjadiCity+Hall%2C+New+York%2C+NY
.Catatan: Parameter ini bersifat opsional, kecuali jika Anda menentukan
origin_place_id
di URL Anda. Jika memilih untuk menentukanorigin_place_id
, Anda juga harus menyertakanorigin
di URL.origin_place_id
(opsional): ID tempat adalah ID tekstual yang secara unik mengidentifikasi tempat. Jika Anda mencoba menentukan tempat usaha secara definitif, menggunakan ID tempat adalah jaminan terbaik bahwa Anda akan menautkan ke tempat yang tepat. URL yang menggunakan parameter ini juga harus menyertakanorigin
.destination
: Menentukan endpoint rute. Jika tidak ada, peta yang dihasilkan dapat menampilkan formulir kosong yang memungkinkan pengguna untuk memasuki tujuan. Nilainya bisa berupa nama tempat, alamat, atau koordinat lintang/bujur yang dipisahkan koma. String harus dienkodekan URL, sehingga alamat seperti "City Hall, New York, NY" harus dikonversi menjadiCity+Hall%2C+New+York%2C+NY
.Catatan: Parameter ini bersifat opsional, kecuali jika Anda menentukan
destination_place_id
di URL Anda. Jika memilih untuk menentukandestination_place_id
, Anda juga harus menyertakandestination
di URL.destination_place_id
(opsional): ID tempat adalah ID tekstual yang secara unik mengidentifikasi tempat. Jika Anda mencoba menentukan tempat usaha secara definitif, menggunakan ID tempat adalah jaminan terbaik bahwa Anda akan menautkan ke tempat yang tepat. URL yang menggunakan parameter ini juga harus menyertakandestination
.travelmode
(opsional): Menentukan metode perjalanan. Opsinya adalahdriving
,walking
(yang lebih memilih jalur pejalan kaki dan trotoar, jika tersedia),bicycling
(yang merutekan melalui jalur sepeda dan jalan pilihan jika tersedia), atautransit
. Jika tidak adatravelmode
yang ditentukan, Google Maps akan menampilkan satu atau beberapa moda yang paling relevan untuk rute dan/atau preferensi pengguna yang ditentukan.dir_action=navigate
(opsional): Meluncurkan navigasi belokan demi belokan atau pratinjau rute ke tujuan yang ditentukan, berdasarkan apakah tempat asal tersedia. Jika pengguna menentukan tempat asal dan tidak dekat dengan lokasi pengguna saat ini, atau lokasi perangkat saat ini tidak tersedia, peta akan meluncurkan pratinjau rute. Jika pengguna tidak menetapkan tempat asal (dalam hal ini asalnya ditetapkan secara default ke lokasi perangkat saat ini), atau asal tersebut dekat dengan lokasi pengguna saat ini, peta akan meluncurkan navigasi belokan demi belokan. Perhatikan bahwa navigasi tidak tersedia di semua produk Google Maps dan/atau di antara semua tujuan; dalam hal ini, parameter ini akan diabaikan.waypoints
: Menentukan satu atau beberapa tempat perantara untuk merutekan rute melalui antaraorigin
dandestination
. Beberapa titik jalan dapat ditentukan dengan menggunakan karakter pipa (|
) untuk memisahkan tempat (misalnyaBerlin,Germany|Paris,France
). Jumlah titik jalan yang diizinkan bervariasi menurut platform tempat link terbuka, dengan maksimum tiga titik jalan didukung pada browser seluler, dan maksimal sembilan titik jalan didukung. Titik jalan ditampilkan di peta dalam urutan yang sama dengan yang tercantum pada URL. Setiap titik jalan bisa berupa nama tempat, alamat, atau koordinat lintang/bujur yang dipisahkan koma. String harus dienkode ke URL, sehingga titik jalan seperti "Berlin,Germany|Paris,France" harus dikonversi menjadiBerlin%2CGermany%7CParis%2CFrance
.Catatan:
- Titik jalan tidak didukung di semua produk Google Maps; dalam hal ini, parameter ini akan diabaikan.
- Parameter ini bersifat opsional, kecuali Anda menentukan
waypoint_place_ids
di URL Anda. Jika memilih untuk menentukanwaypoint_place_ids
, Anda juga harus menyertakanwaypoints
dalam URL.
waypoint_place_ids
(opsional): ID tempat adalah ID tekstual yang secara unik mengidentifikasi tempat.Waypoint_place_ids
memungkinkan Anda memberikan daftar ID tempat agar cocok dengan daftarwaypoints
. ID tempat harus dicantumkan dalam urutan yang sama dengan titik jalan, dan dipisahkan menggunakan karakter pipa "|
" (dienkode URL sebagai%7C
). Jika Anda mencoba menentukan tempat usaha secara definitif, ID tempat adalah jaminan terbaik bahwa Anda akan ditautkan ke tempat yang tepat. URL yang menggunakan parameter ini juga harus menyertakanwaypoints
.
Contoh rute
URL berikut meluncurkan peta dalam mode rute dan menyediakan formulir untuk memungkinkan pengguna memasukkan tempat asal dan tujuan.
https://www.google.com/maps/dir/?api=1
Contoh berikut meluncurkan peta dengan rute sepeda dari Space Needle ke Pike Place Market, di Seattle, WA.
Contoh berikut meluncurkan peta dengan rute jalan kaki dari Google di Sydney, Australia, ke Queen Victoria Building.
Menampilkan peta
Tindakan peta menampilkan peta tanpa penanda atau rute.
Membentuk URL peta
https://www.google.com/maps/@?api=1&map_action=map¶meters
Parameter
map_action=map
(wajib): Menentukan jenis tampilan peta yang akan ditampilkan. Maps dan Street View memiliki endpoint yang sama. Untuk memastikan peta ditampilkan,map_action
harus ditetapkan sebagaimap
.center
(opsional): Menentukan bagian tengah jendela peta, dan menerima koordinat garis lintang/bujur sebagai nilai yang dipisahkan koma (misalnya,-33.8569,151.2152
).zoom
(opsional): Menetapkan tingkat zoom awal peta. Nilai yang diterima adalah bilangan bulat yang berkisar dari 0 (seluruh dunia) hingga 21 (setiap bangunan). Batas atas dapat bervariasi bergantung pada data peta yang tersedia di lokasi yang dipilih. Jumlah defaultnya adalah 15.basemap
(opsional): Menentukan jenis peta yang akan ditampilkan. Nilainya bisaroadmap
(default),satellite
, atauterrain
.layer
(opsional): Menentukan lapisan tambahan yang akan ditampilkan di peta, jika ada. Nilainya dapat berupa salah satu dari berikut:none
(default),transit
,traffic
, ataubicycling
.
Contoh peta
Contoh URL ini meluncurkan Google Maps default, yang berpusat pada lokasi pengguna saat ini.
https://www.google.com/maps/@?api=1&map_action=map
Contoh berikut menampilkan peta yang berpusat di Katoomba, NSW, Australia (di -33.712206,150.311941
), dan menetapkan parameter zoom
dan basemap
opsional.
Menampilkan panorama Street View
Tindakan panorama memungkinkan Anda meluncurkan penampil untuk menampilkan gambar Street View sebagai panorama interaktif. Setiap panorama Street View memberikan tampilan 360 derajat penuh dari satu lokasi. Gambar berisi tampilan horizontal 360 derajat (satu putaran penuh) dan tampilan vertikal 180 derajat (dari lurus ke atas sampai lurus ke bawah). Tindakan panorama meluncurkan penampil yang merender panorama yang dihasilkan sebagai bola dunia dengan kamera di tengahnya. Anda dapat memanipulasi kamera untuk mengontrol zoom dan orientasi kamera.
Google Street View memberikan tampilan panorama dari lokasi yang ditetapkan ke seluruh area cakupannya. Photosphere kontribusi pengguna dan koleksi khusus Street View juga tersedia.
Membentuk URL Street View
https://www.google.com/maps/@?api=1&map_action=pano¶meters
Parameter
map_action=pano
(wajib): Menentukan jenis tampilan yang akan ditampilkan. Maps dan Street View memiliki endpoint yang sama. Untuk memastikan panorama ditampilkan,action
harus ditentukan sebagaipano
.
Salah satu parameter URL berikut juga wajib diisi:
viewpoint
: Penampil menampilkan foto panorama yang terdekat dengan lokasiviewpoint
, yang ditetapkan sebagai koordinat lintang/bujur yang dipisahkan koma (misalnya, 46.414382,10.013988). Karena gambar Street View secara berkala diperbarui, dan foto dapat diambil dari posisi yang sedikit berbeda, sehingga lokasi Anda mungkin dapat bergeser ke panorama yang berbeda saat gambar diperbarui.pano
: ID panorama spesifik gambar untuk ditampilkan. Jika menentukanpano
, Anda juga dapat menentukanviewpoint
.viewpoint
hanya digunakan jika Google Maps tidak dapat menemukan ID panorama. Jikapano
ditentukan tetapi tidak ditemukan, danviewpoint
TIDAK ditentukan, tidak ada gambar panorama yang akan ditampilkan. Sebagai gantinya, Google Maps akan terbuka dalam mode default, yang menampilkan peta yang berpusat pada lokasi pengguna saat ini.
Parameter URL berikut ini bersifat opsional:
heading
: Menunjukkan arah kompas kamera dalam derajat searah jarum jam dari Utara. Nilai yang diterima adalah dari -180 hingga 360 derajat. Jika dihilangkan, judul default dipilih berdasarkan sudut pandang (jika ditentukan) kueri dan lokasi gambar yang sebenarnya.pitch
: Menentukan sudut, naik atau turun, pada kamera. Nada ditentukan dalam derajat dari -90 hingga 90. Nilai positif akan menaikkan sudut kamera, sementara nilai negatif akan menurunkan sudut kamera. Presentasi default 0 ditetapkan berdasarkan posisi kamera saat gambar diambil. Karena itu, pitch 0 sering kali, tetapi tidak selalu, horizontal. Misalnya, gambar yang diambil dari atas bukit kemungkinan akan menampilkan pitch default yang tidak horizontal.fov
: Menentukan ruang pandang horizontal gambar. Ruang pandang dinyatakan dalam derajat, dengan rentang 10 - 100. Setelan defaultnya adalah 90. Saat menangani area pandang ukuran tetap, ruang pandang dianggap sebagai tingkat zoom, dengan angka lebih kecil yang menunjukkan tingkat zoom lebih tinggi.
Contoh Street View
Dua contoh pertama menampilkan panorama Eiffel Tower. Contoh satu hanya menggunakan viewpoint
untuk lokasi, dan menetapkan parameter heading
, pitch
, dan fov
opsional. Sebagai perbandingan,
contoh kedua menggunakan ID pano
serta parameter yang sama yang ditetapkan pada
contoh pertama. Contoh ketiga menampilkan gambar panorama dalam ruangan.
Contoh 1: Hanya menggunakan viewpoint
untuk menentukan lokasi.
Contoh 2: Menggunakan ID pano
serta lokasi viewpoint
.
ID pano
lebih diprioritaskan daripada viewpoint
.
Dalam contoh ini, ID panorama ditemukan, sehingga viewpoint
diabaikan. Perhatikan bahwa gambar panorama yang ditampilkan untuk ID pano
sedikit berbeda, dan lebih baru, daripada gambar yang ditemukan hanya menggunakan viewpoint
.
Contoh 3: Menampilkan panorama interior restoran Sarastro di London, Inggris Raya, yang ditentukan dengan ID panorama.
https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA
Menemukan ID panorama
Untuk menemukan ID gambar panorama tertentu, ada beberapa metode yang dapat Anda gunakan.
- Untuk JavaScript, gunakan class StreetViewPanorama.
- Untuk Android, gunakan class publik StreetViewPanoramaLocation.
- Untuk iOS, gunakan class GMSPanorama.
- Anda juga dapat membuat permintaan metadata menggunakan Google Street View Image API. Permintaan metadata gambar memberikan data tentang panorama Street View, termasuk ID panorama.
Contoh lainnya
Contoh rute menggunakan titik jalan
Contoh rute berikut meluncurkan Google Maps dan menampilkan rute mobil dari Paris, Prancis ke Cherbourg, Prancis, yang melalui titik jalan berikut:
Kota, Negara | Nama Tempat | ID Tempat |
---|---|---|
1. Versailles, Prancis | Istana Versailles | ChIJdUyx15R95kcRj85MX8H8OAU |
2. Chartres, Prancis | Katedral Chartres | ChIJKzGHdEgM5EcR_OBTT3nQoEA |
3. Le Mans, Prancis | Katedral Saint Julian dari Le Mans | ChIJG2LvQNCI4kcRKXNoAsPi1Mc (hanya dalam bahasa Inggris) |
4. Caen, Prancis | Kastil Caen | ChIJ06tnGbxCCkgRsfNjEQMwUsc |
Dalam contoh URL, titik jalan ditentukan dengan cara yang berbeda sehingga Anda dapat membandingkan perbedaan tampilan titik jalan di peta yang dihasilkan.
Contoh 1: Titik jalan yang didefinisikan sebagai Kota, Negara:
Contoh 2: Titik jalan yang didefinisikan sebagai nama tempat tertentu:
Contoh 3: Titik jalan yang didefinisikan sebagai Kota, Negara, dan juga menyediakan
waypoint_place_ids
untuk tempat usaha tertentu di setiap titik jalan:
Contoh 4: Menetapkan titik jalan sebagai Kota, Negara, tetapi mencantumkan titik jalan dalam urutan berbeda dibandingkan contoh sebelumnya. Mendemonstrasikan bahwa peta menampilkan titik jalan dalam urutan yang tercantum di URL.
Contoh peta
Menampilkan peta dengan basemap
yang ditentukan (satelit) dan layer
(transit).
Contoh Street View
Menampilkan panorama Street View menggunakan kunci gambar FIFE sebagai ID pano
. Perlu diketahui
bahwa ID pano
diawali dengan F:.