Mulai

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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, terlepas dari 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 dan akan membuka Google Maps serta melakukan tindakan yang diminta, apa pun 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 terinstal 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 terinstal, 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 bentuk 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 — meluncurkan 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 di URL, semua parameter akan diabaikan dan aplikasi Google Maps default akan diluncurkan, baik di browser maupun aplikasi seluler Google Maps, bergantung pada platform yang digunakan (misalnya, https://www.google.com/maps).

Membuat URL yang valid

Anda harus mengenkode dengan benar URL.

Misalnya, beberapa parameter menggunakan karakter pipa (|) sebagai pemisah, yang harus Anda enkode sebagai %7C di 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 di URL permintaan, beserta parameter wajib dan opsional. Seperti standar pada URL, Anda memisahkan parameter menggunakan karakter ampersand (&). Untuk setiap tindakan, daftar parameter dan kemungkinan nilainya dihitung di bagian Parameter Penelusuran.

Telusuri

Tindakan penelusuran menampilkan hasil untuk penelusuran di seluruh wilayah peta yang terlihat. Saat menelusuri tempat tertentu, peta yang dihasilkan akan menempatkan pin di lokasi yang ditentukan dan menampilkan detail tempat yang tersedia.

Membuat 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 dienkode ke 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 yang dienkode ke 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 akan 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 mengkueri 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 di lokasi tersebut. Ketiga contoh ini menggambarkan penelusuran untuk lokasi yang sama, CenturyLink Field (gedung olahraga di Seattle, WA), menggunakan nilai lokasi yang berbeda.

Contoh 1: Menelusuri nama tempat "Kolom CenturyLink" menghasilkan peta berikut:

https://www.google.com/maps/search/?api=1&query=centurylink+field

Contoh 2: Menelusuri Kolom CenturyLink menggunakan koordinat lintang/bujur serta 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 koordinat lintang/bujur akan menghasilkan peta berikut. Perhatikan bahwa ada pin pada peta, tetapi tidak ada informasi tempat tambahan yang diberikan pada peta atau panel samping:

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

Penelusuran kategoris

Dalam penelusuran kategori, Anda memenuhi istilah penelusuran umum, dan Google Maps akan berupaya menemukan listingan yang cocok dengan kriteria Anda di dekat lokasi yang Anda tentukan. Jika tidak ada lokasi yang ditentukan, Google Maps akan berupaya menemukan listingan di sekitar lokasi Anda saat ini. Jika Anda lebih suka menyediakan 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


Directions

Tindakan rute menampilkan jalur antara dua atau beberapa titik yang ditentukan pada peta, serta jarak dan waktu perjalanan.

Membuat URL Rute

https://www.google.com/maps/dir/?api=1&parameters

Parameter

  • origin: Menentukan titik awal untuk menampilkan rute. Default ke lokasi awal yang paling relevan, seperti lokasi pengguna, jika tersedia. Jika tidak ada, peta yang dihasilkan dapat memberikan formulir kosong untuk memungkinkan pengguna memasukkan tempat asal. Nilainya bisa berupa nama tempat, alamat, atau koordinat lintang/bujur yang dipisahkan koma. String harus dienkode ke 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 secara pasti sebuah tempat usaha, penggunaan 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 memberikan formulir kosong agar pengguna dapat memasuki tujuan. Nilainya bisa berupa nama tempat, alamat, atau koordinat lintang/bujur yang dipisahkan koma. String harus dienkode ke 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 secara pasti sebuah tempat usaha, penggunaan 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 rute melalui jalur sepeda dan jalan pilihan jika tersedia), atau transit. Jika travelmode tidak ditentukan, Google Maps akan menampilkan satu atau beberapa mode 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 ketersediaan asal. Jika pengguna menentukan tempat asal dan tidak dekat dengan lokasi pengguna saat ini, atau lokasi pengguna saat ini tidak tersedia, peta akan meluncurkan pratinjau rute. Jika pengguna tidak menetapkan tempat asal (dalam hal ini tempat asal merupakan default untuk lokasi pengguna saat ini), atau tempat asal 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 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 dibuka, dengan hingga tiga titik jalan yang didukung pada browser seluler, dan maksimal sembilan titik jalan yang didukung. Titik jalan ditampilkan di peta dengan urutan yang sama seperti yang tercantum pada URL. Setiap titik jalan dapat berupa nama tempat, alamat, atau koordinat lintang/bujur yang dipisahkan koma. String harus dienkode ke URL, sehingga titik jalan seperti "Berlin,Jerman|Paris,Prancis" harus dikonversi ke Berlin%2CGermany%7CParis%2CFrance.

    Catatan:

    • Titik jalan tidak didukung di semua produk Google Maps; dalam kasus tersebut, parameter ini akan diabaikan.
    • Parameter ini opsional, kecuali jika Anda menentukan waypoint_place_ids di URL Anda. Jika memilih untuk menentukan waypoint_place_ids, Anda juga harus menyertakan waypoints di 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 dengan URL sebagai %7C). Jika Anda mencoba menentukan tempat tertentu secara definitif, ID tempat adalah jaminan terbaik bahwa Anda akan menautkan 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 yang 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 berjalan 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 ditentukan 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 mulai dari 0 (seluruh dunia) hingga 21 (setiap bangunan). Batas atas dapat bervariasi bergantung pada data peta yang tersedia di lokasi yang dipilih. Defaultnya adalah 15.
  • basemap (opsional): Menentukan jenis peta yang akan ditampilkan. Nilainya bisa roadmap (default), satellite, atau terrain.
  • layer (opsional): Menetapkan lapisan tambahan untuk ditampilkan pada peta, jika ada. Nilainya bisa 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 menyediakan tampilan panorama dari lokasi tertentu melalui area cakupan. Photospheres 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 diperlukan:

  • viewpoint: Penampil menampilkan foto panorama yang paling dekat dengan lokasi viewpoint, yang ditetapkan sebagai koordinat lintang/bujur yang dipisahkan koma (misalnya 46.414382,10.013988). Karena gambar Street View diperbarui secara berkala, dan foto dapat diambil dari posisi yang sedikit berbeda setiap kali, lokasi Anda mungkin akan bergeser ke panorama yang berbeda saat gambar diperbarui.
  • pano: ID panorama spesifik untuk gambar yang akan 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 di lokasi pengguna saat ini.

Parameter URL berikut ini bersifat opsional:

  • heading: Menunjukkan judul kompas kamera dalam derajat searah jarum jam dari Utara. Nilai yang diterima adalah dari -180 hingga 360 derajat. Jika dihilangkan, judul default akan dipilih berdasarkan sudut pandang (jika ditentukan) kueri dan lokasi gambar yang sebenarnya.
  • pitch: Menentukan sudut, naik atau turun, pada kamera. Presentasi ditentukan dalam derajat dari -90 sampai 90. Nilai positif akan menaikkan sudut kamera, sedangkan nilai negatif akan menurunkan sudut kamera. Pitch default 0 ditetapkan berdasarkan posisi kamera saat gambar diambil. Karena itu, nada 0 sering kali, tetapi tidak selalu, horizontal. Misalnya, gambar yang diambil dari atas bukit kemungkinan akan menampilkan pitch default yang tidak horizontal.
  • fov: Menentukan bidang 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 dua menggunakan ID pano serta parameter yang sama yang ditetapkan di contoh pertama. Contoh ketiga menampilkan gambar panorama indoor.

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

Ada beberapa metode yang dapat Anda gunakan untuk menemukan ID gambar panorama tertentu.

Contoh lainnya

Contoh rute menggunakan titik jalan

Contoh rute berikut meluncurkan Google Maps dan menampilkan rute mobil dari Paris, Prancis ke Cherbourg, Prancis, yang melewati 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
4. Caen, Prancis Kastil Caen ChIJ06tnGbxCCkgRsfNjEQMwUsc

Dalam contoh URL, titik jalan ditentukan dengan cara yang berbeda sehingga Anda dapat membandingkan perbedaan tampilan titik jalan pada 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 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 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: Menentukan titik jalan sebagai Kota, Negara, tetapi mencantumkan titik jalan dalam urutan yang berbeda dibandingkan dengan contoh sebelumnya. Menunjukkan bahwa peta menampilkan titik jalan sesuai urutan yang tercantum dalam 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 (satelit) dan layer (transit) yang ditentukan.

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 diperhatikan 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