Mulai

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:

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&parameters
  • Rute — minta rute dan luncurkan Google Maps dengan hasil:
    https://www.google.com/maps/dir/?api=1&parameters
  • Menampilkan peta — luncurkan Google Maps tanpa penanda atau rute:
    https://www.google.com/maps/@?api=1&map_action=map&parameters
  • Menampilkan panorama Street View — luncurkan gambar panorama interaktif:
    https://www.google.com/maps/@?api=1&map_action=pano&parameters

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&parameters

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 atau restaurants+in+seattle+wa.
  • query_place_id (opsional): ID tempat adalah ID tekstual yang secara unik mengidentifikasi tempat. Untuk tindakan search, Anda harus menentukan query, tetapi Anda juga dapat menentukan query_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 mengirimkan query_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:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393&query_place_id=ChIJKxjxuaNqkFQR3CK6O1HNNqY

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&parameters

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 menjadi City+Hall%2C+New+York%2C+NY.

    Catatan: Parameter ini bersifat opsional, kecuali jika Anda menentukan origin_place_id di URL Anda. Jika memilih untuk menentukan origin_place_id, Anda juga harus menyertakan origin 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 menyertakan origin.
  • 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 menjadi City+Hall%2C+New+York%2C+NY.

    Catatan: Parameter ini bersifat opsional, kecuali jika Anda menentukan destination_place_id di URL Anda. Jika memilih untuk menentukan destination_place_id, Anda juga harus menyertakan destination 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 menyertakan destination.
  • travelmode (opsional): Menentukan metode perjalanan. Opsinya adalah driving, walking (yang lebih memilih jalur pejalan kaki dan trotoar, jika tersedia), bicycling (yang merutekan melalui jalur sepeda dan jalan pilihan jika tersedia), atau transit. Jika tidak ada travelmode 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 antara origin dan destination. Beberapa titik jalan dapat ditentukan dengan menggunakan karakter pipa (|) untuk memisahkan tempat (misalnya Berlin,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 menjadi Berlin%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 menentukan waypoint_place_ids, Anda juga harus menyertakan waypoints 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 daftar waypoints. 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 menyertakan waypoints.

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.

https://www.google.com/maps/dir/?api=1&origin=Space+Needle+Seattle+WA&destination=Pike+Place+Market+Seattle+WA&travelmode=bicycling

Contoh berikut meluncurkan peta dengan rute jalan kaki dari Google di Sydney, Australia, ke Queen Victoria Building.

https://www.google.com/maps/dir/?api=1&origin=Google+Pyrmont+NSW&destination=QVB&destination_place_id=ChIJISz8NjyuEmsRFTQ9Iw7Ear8&travelmode=walking


Menampilkan peta

Tindakan peta menampilkan peta tanpa penanda atau rute.

Membentuk URL peta

https://www.google.com/maps/@?api=1&map_action=map&parameters

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 sebagai map.
  • 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 bisa roadmap (default), satellite, atau terrain.
  • layer (opsional): Menentukan lapisan tambahan yang akan ditampilkan di peta, jika ada. Nilainya dapat berupa salah satu dari berikut: none (default), transit, traffic, atau bicycling.

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.

https://www.google.com/maps/@?api=1&map_action=map&center=-33.712206%2C150.311941&zoom=12&basemap=terrain


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&parameters

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 sebagai pano.

Salah satu parameter URL berikut juga wajib diisi:

  • viewpoint: Penampil menampilkan foto panorama yang terdekat dengan lokasi viewpoint, 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 menentukan pano, Anda juga dapat menentukan viewpoint. viewpoint hanya digunakan jika Google Maps tidak dapat menemukan ID panorama. Jika pano ditentukan tetapi tidak ditemukan, dan viewpoint 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.

https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

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.

https://www.google.com/maps/@?api=1&map_action=pano&pano=tu510ie_z4ptBZYo2BGEJg&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

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.

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, NegaraNama TempatID 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:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance

Contoh 2: Titik jalan yang didefinisikan sebagai nama tempat tertentu:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Palace+of+Versailles%7CChartres+Cathedral%7CCathedral+of+Saint+Julian+of+Le+Mans%7CCaen+Castle

Contoh 3: Titik jalan yang didefinisikan sebagai Kota, Negara, dan juga menyediakan waypoint_place_ids untuk tempat usaha tertentu di setiap titik jalan:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance&waypoint_place_ids=ChIJdUyx15R95kcRj85ZX8H8OAU%7CChIJKzGHdEgM5EcR_OBTT3nQoEA%7CChIJG2LvQNCI4kcRKXNoAsPi1Mc%7CChIJ06tnGbxCCkgRsfNjEQMwUsc

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.

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CCaen%2CFrance%7CLe+Mans%2CFrance%7CChartres%2CFrance

Contoh peta

Menampilkan peta dengan basemap yang ditentukan (satelit) dan layer (transit).

https://www.google.com/maps/@?api=1&map_action=map&center=37.7992940%2C-122.3976113&zoom=15&basemap=satellite&layer=transit

Contoh Street View

Menampilkan panorama Street View menggunakan kunci gambar FIFE sebagai ID pano. Perlu diketahui bahwa ID pano diawali dengan F:.

https://www.google.com/maps/@?api=1&map_action=pano&pano=F:-ud6AZSB-sQg/V0cfCSV3OWI/AAAAAAAAG1U/UQEoc5sXPQEIP7zzD6SWzmKb8Vbug47uQCLIB&heading=22&pitch=-5&fov=55