Intent Google Maps untuk Android Automotive

Melalui intent Android, Anda dapat meluncurkan navigasi di Google Maps untuk Android Automotive.

Ringkasan

Halaman ini menjelaskan maksud yang dapat Anda gunakan dengan Google Maps untuk Android Automotive. Untuk dokumentasi developer Android yang mendetail, lihat berikut ini:

• Intent dan Filter Intent
• Intent umum untuk platform Android

Permintaan intent

Untuk meluncurkan Google Maps untuk Android Automotive dengan intent, Anda harus membuat objek Intent terlebih dahulu, dengan menentukan tindakan, URI, dan paketnya.

• Tindakan. Semua intent Google Maps dipanggil sebagai tindakan View, ACTION_VIEW.

• URI. Intent Google Maps menggunakan string yang dienkode URI yang menentukan tindakan yang dipilih, beserta beberapa data yang digunakan untuk melakukan tindakan tersebut.

• Paket. Memanggil setPackage("com.google.android.apps.maps") memastikan bahwa aplikasi Google Maps untuk Android menangani Intent. Jika paket tidak ditetapkan, sistem akan menentukan aplikasi mana yang dapat menangani Intent. Jika tersedia beberapa aplikasi, Anda mungkin akan ditanya aplikasi mana yang ingin Anda gunakan.

Setelah membuat Intent, Anda dapat meminta sistem meluncurkan aplikasi terkait dengan beberapa cara. Metode umum adalah meneruskan Intent ke metode startActivity(). Sistem akan meluncurkan aplikasi yang diperlukan, dalam hal ini, Google Maps, dan memulai Activity yang sesuai.

// Create a Uri from an intent string. Use the result to create an Intent.
Uri mapIntentUri =
Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
// Create an Intent from mapIntentUri. Set the action to ACTION_VIEW
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
// Make the Intent explicit by setting the Google Maps package
mapIntent.setPackage("com.google.android.apps.maps");
// Attempt to start an activity that can handle the Intent
startActivity(mapIntent);

Jika sistem tidak dapat mengidentifikasi aplikasi yang dapat merespons Intent, aplikasi Anda dapat mengalami error. Oleh karena itu, verifikasi terlebih dahulu bahwa aplikasi penerima telah diinstal sebelum Anda menampilkan salah satu intent ini kepada pengguna.

Untuk memverifikasi bahwa aplikasi tersedia untuk menerima intent, panggil resolveActivity() pada objek Intent Anda. Jika hasilnya tidak null, berarti ada minimal satu aplikasi yang dapat menangani intent dan aman untuk memanggil startActivity(). Jika hasilnya null, Anda tidak boleh menggunakan intent dan, jika memungkinkan, nonaktifkan fitur yang memanggil intent.

if (mapIntent.resolveActivity(getPackageManager()) != null) {
...
}

Misalnya, untuk meluncurkan navigasi belokan demi belokan ke Taronga Zoo di Sydney, Anda dapat menggunakan kode berikut:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
if (mapIntent.resolveActivity(getPackageManager()) != null) {
startActivity(mapIntent);
}

String kueri yang dienkode URI

Semua string yang diteruskan ke intent Google Maps harus dienkode URI. Misalnya, string "1st & Pike, Seattle" harus menjadi 1st%20%26%20Pike%2C%20Seattle. Spasi dalam string dapat dienkode dengan %20 atau diganti dengan tanda plus (+).

Anda dapat menggunakan metode android.net.Uri encode() untuk mengenkode string. Contoh:

Uri mapIntentUri = Uri.parse("google.navigation:q=" + Uri.encode("1st & Pike, Seattle"));

Menampilkan peta

Gunakan maksud geo: untuk menampilkan peta di lokasi dan tingkat zoom yang ditentukan. Contoh:

geo:latitude,longitude?z=zoom

Parameter

• latitude dan longitude menetapkan titik tengah peta.

• z secara opsional menetapkan tingkat zoom awal peta. Rentang nilai yang diterima adalah dari 0 (seluruh dunia) hingga 21 (bangunan individual). Batas atas dapat bervariasi bergantung pada data peta yang tersedia di lokasi yang dipilih.

Contoh

// Creates an intent that will load a map of San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Telusuri lokasi

Gunakan intent ini untuk menampilkan kueri penelusuran dalam area tampilan yang ditentukan:

geo:latitude,longitude?q=query
geo:0,0?q=my+street+address

Parameter

Selain parameter yang digunakan untuk menampilkan peta, Penelusuran mendukung parameter ini:

• q menentukan tempat yang akan ditandai di peta. Parameter q diperlukan untuk semua permintaan Penelusuran. API ini menerima lokasi sebagai nama tempat atau alamat. String harus di-escape URL, sehingga alamat seperti "City Hall, New York, NY" harus dikonversi menjadi City+Hall%2CNew+York%2CNY.

Membiaskan hasil penelusuran dengan koordinat

Saat menelusuri lokasi yang sangat spesifik, garis lintang dan bujur tidak diperlukan secara ketat jika disertakan dalam parameter q. Namun, jika Anda tidak mengetahui alamat persisnya atau kuerinya ambigu, Anda dapat mencoba memengaruhi hasil penelusuran dengan menentukan koordinat. Misalnya, melakukan penelusuran alamat untuk "Main Street" dapat menampilkan terlalu banyak hasil:

// Searching for "101 Main Street" with no lat/long might return too many results
Uri gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Menambahkan lintang dan bujur ke URI intent akan memengaruhi hasil ke area tertentu:

// Searches for "101 Main Street" near San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=101+main+street");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Telusuri sepanjang rute

Jika maksud penelusuran geo:latitude,longitude?q=query dikirim selama navigasi, penelusuran di sepanjang rute akan dipicu dan lintang serta bujur akan diabaikan.

Menelusuri kategori standar

Untuk mendukung integrasi dengan kendaraan, Google Maps di mobil mendukung intent yang menampilkan kategori yang telah ditentukan sebelumnya ini:

Intent kategori berbentuk geo:lat,lng?c=category.

Gunakan c=<pre-defined category> terlepas dari setelan lokalitas pengguna. Google Maps menampilkan hasil yang relevan dalam lokalitas yang sesuai untuk kategori ini. Contoh:

// Search for gas stations nearby
Uri gmmIntentUri = Uri.parse("geo:0,0?c=gas_station");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Penelusuran kategoris lainnya

Jika Anda meneruskan istilah penelusuran umum (seperti "restoran" atau "kafe") di lokalitas pengguna, Google Maps untuk Android Automotive akan menelusuri listingan bisnis yang cocok dengan kriteria. Jika lintang dan bujur tertentu diberikan dalam intent geo:, penelusuran akan berpusat di sekitar lokasi tersebut. Jika tidak ada lokasi yang ditentukan (misalnya, geo:0,0), Google Maps mencoba menemukan listingan bisnis di sekitar. Contoh:

// Search for restaurants nearby
Uri gmmIntentUri = Uri.parse("geo:0,0?q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Anda dapat lebih membiaskan hasil penelusuran dengan menentukan parameter zoom bersama dengan string kueri. Dalam contoh berikut, menambahkan zoom 10 mencoba menemukan restoran di tingkat kota, bukan di sekitar:

Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?z=10&q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Mulai navigasi belokan demi belokan

Untuk dokumentasi tentang meluncurkan navigasi belokan demi belokan di perangkat Android lain, lihat Meluncurkan navigasi belokan demi belokan di Intent Google Maps untuk Android.

Gunakan intent ini untuk meluncurkan navigasi Google Maps dengan rute belokan demi belokan ke satu atau beberapa alamat atau koordinat yang ditentukan. Rute selalu diberikan dari lokasi pengguna saat ini.

google.navigation:q=a+street+address
google.navigation:q=latitude,longitude
google.navigation:place=placename

Parameter

Untuk meluncurkan navigasi, gunakan place atau q dengan waypoints, yang bersifat opsional. Untuk menandai titik jalan sebagai stasiun pengisian daya secara opsional, lihat Mengirim rencana perjalanan kendaraan listrik ke Google Maps.

• q menetapkan titik akhir untuk penelusuran navigasi. Ini dapat berupa lintang dan bujur atau alamat yang diformat kueri. Jika berupa string kueri yang menampilkan lebih dari satu hasil, hasil pertama akan dipilih.

• place menetapkan titik akhir ke rumah atau kantor. Tentukan rumah untuk mendapatkan panduan navigasi ke rumah pengguna, dan kantor untuk mendapatkan panduan navigasi ke tempat kerja pengguna.

• avoid menetapkan fitur yang harus dihindari oleh rute. avoid bersifat opsional dan dapat ditetapkan ke satu atau beberapa nilai berikut:

  • t untuk tarif tol
  • h untuk jalan raya
  • f untuk feri

• waypoints menentukan satu atau beberapa tempat perantara untuk merutekan arah ke tujuan akhir yang ditentukan oleh q. Anda dapat menentukan beberapa titik jalan dengan menggunakan karakter pipa (|) untuk memisahkan tempat—misalnya, Berlin,Germany|Paris,France. Anda dapat menggunakan sebanyak mungkin titik jalan sesuai kebutuhan. Titik jalan akan ditambahkan ke rute dalam urutan yang sama dengan yang tercantum di URL. Setiap titik jalan dapat berupa alamat atau koordinat lintang dan bujur yang dipisahkan koma; dan, Anda dapat memiliki alamat dan koordinat lintang dan bujur dalam maksud yang sama. String harus di-escape URL, sehingga titik jalan seperti "Berlin,Jerman|Paris,Prancis" harus dikonversi menjadi Berlin%2CGermany%7CParis%2CFrance.

Contoh

Intent ini akan meminta navigasi belokan demi belokan ke Taronga Zoo, di Sydney, Australia:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Jika tidak ingin membayar tol atau naik feri, Anda dapat meminta perutean yang berupaya menghindari situasi ini:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&avoid=tf");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Atau, jika Anda lebih suka bernavigasi ke rumah, gunakan:

Uri mapIntentUri = Uri.parse("google.navigation:place=home");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Untuk meluncurkan navigasi belokan demi belokan ke tiga alamat berikut secara berurutan, teruskan Taronga Zoo sebagai tujuan akhir q, dan Google Sydney serta Sydney Opera House sebagai titik perantara:

1. Google Sydney

2. Sydney Opera House

3. Taronga Zoo, Sydney Australia

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&waypoints=Google+Sydney%7CSydney+Opera+House");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Mirip dengan q, Anda dapat merepresentasikan titik jalan mana pun dengan lintang dan bujur yang dipisahkan koma, bukan alamat. Misalnya, untuk meluncurkan navigasi yang sama sambil meneruskan garis lintang dan bujur Sydney Opera House, bukan alamat:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&waypoints=Google+Sydney%7C-33.856159,151.215256");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Mengirim rencana perjalanan kendaraan listrik ke Google Maps

Gunakan maksud navigasi multi-tujuan ini untuk menentukan beberapa tujuan sebagai perhentian pengisian daya kendaraan listrik (EV). Maksud ini, yang memperluas maksud multi-titik jalan, membantu pengemudi mempertahankan daya baterai kendaraan listrik yang cukup untuk mencapai tujuan mereka dengan menyinkronkan informasi SPKLU antara aplikasi perencanaan perjalanan EV dan Google Maps.

Untuk perhentian pengisian daya, maksud perjalanan:

• Harus berisi nama dan lat-long
• Dapat secara opsional berisi output daya, yang akan digunakan untuk menghitung waktu pengisian daya

Google menggunakan nama dan garis lintang/bujur SPKLU untuk menemukan tempat SPKLU yang cocok untuk menampilkan data lengkap seperti jenis konektor, total, kecepatan, dan ketersediaan real-time, metode pembayaran yang didukung, dan lokasi menarik (POI) host. Misalnya, petunjuk arah di dalam tempat parkir luar ruangan untuk bagian akhir navigasi, jam buka, rating. Untuk memastikan bahwa stasiun pengisian daya cocok dengan data Google, gunakan <brand name> tertentu—misalnya, ChargePoint.

Parameter

Parameter berikut memungkinkan Anda menentukan detail untuk tujuan akhir dan titik jalan, termasuk yang ditetapkan sebagai SPKLU.

Tujuan akhir

Untuk menetapkan SPKLU sebagai tujuan akhir, gunakan:

• q: Harus berisi nilai garis lintang-bujur SPKLU.
• q_type: 1 menentukan bahwa tujuan akhir adalah stasiun pengisian daya.
• q_name: Nama tujuan akhir. Wajib jika q_type adalah 1.
• q_power_output_kw: Angka ganda untuk output daya stasiun pengisian dalam kilowatt. Opsional.

Titik jalan

Untuk titik jalan, semua parameter adalah array nilai yang dipisahkan dengan pipa (|) secara paralel dalam urutan yang sama dengan titik jalan, tidak termasuk tujuan akhir. Ketidakcocokan jumlah elemen dalam array paralel dianggap sebagai maksud yang salah bentuk.

Untuk menambahkan satu atau beberapa titik jalan SPKLU, gunakan parameter berikut, yang semuanya bersifat opsional. Jika salah satu tujuan ditandai sebagai SPKLU, nama titik jalan menjadi wajib untuk tujuan tersebut.

• waypoints: Daftar titik jalan seperti yang dijelaskan dalam maksud navigasi belokan demi belokan. Harus berupa nilai lat-long untuk titik jalan SPKLU.

• waypoint_types: Jenis per titik jalan yang ditentukan sebagai angka. 0 adalah perhentian mana pun (nilai default) dan 1 adalah stasiun pengisian daya.

• waypoint_names: Nama titik jalan. Kolom ini wajib diisi untuk stasiun pengisian daya.

• waypoint_power_outputs_kw: Angka ganda untuk daya stasiun pengisian dalam kilowatt. Untuk SPKLU, Anda dapat secara opsional menentukan nilai output daya titik jalan, yang digunakan sebagai penggantian jika SPKLU yang cocok tidak ditemukan. Slot kosong berarti tidak ada nilai yang diberikan.

Perilaku pengalaman pengguna (UX)

Untuk maksud perjalanan dengan beberapa tujuan, layar ringkasan rute ditampilkan, tetapi navigasi tidak dimulai secara otomatis.

Untuk maksud yang diformat dengan benar, Google Maps akan menampilkan layar ringkasan rute untuk perjalanan. Layar ringkasan rute akan menampilkan semua titik jalan dan tujuan akhir dari maksud, dengan rekomendasi pengisian daya jika berlaku.

Untuk setiap titik jalan atau tujuan akhir yang ditandai sebagai SPKLU, Google Maps akan menelusuri tempat yang cocok di database Google. Untuk memastikan informasi terbaik ditampilkan untuk SPKLU:

• Jika kecocokan ditemukan, Google Maps menggunakan data Google untuk menampilkan SPKLU di antarmuka pengguna (UI) dan memberikan rekomendasi pengisian daya untuk SPKLU tersebut.

• Jika kecocokan tidak ditemukan, data yang diberikan dalam maksud untuk SPKLU (lat-long, nama, dan output daya) digunakan untuk menampilkan SPKLU ini di UI dan memberikan rekomendasi pengisian daya di SPKLU ini.

Contoh

Contoh berikut menggambarkan cara membuat maksud untuk berbagai skenario perencanaan perjalanan EV, termasuk mendapatkan panduan arah melalui beberapa SPKLU dan menangani output daya yang tidak diketahui.

Menuju ke tujuan akhir melalui beberapa SPKLU

Intent berikut akan menunjukkan jalan ke tujuan akhir, Port Macquarie NSW, melalui dua SPKLU, ChargePoint dan Evie.

Tujuan secara berurutan:

1. SPKLU ChargePoint (lokasi: -32.9599188,151.6240806, output daya: 6,6 kW)

2. Stasiun Pengisian Daya Evie (lokasi: -31.9432539,152.4699808, output daya: 350 kW)

3. Port Macquarie NSW

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=Port+Macquarie+NSW"
            + "&waypoints=-32.9599188%2C151.6240806%7C-31.9432539%2C152.4699808"
            + "&waypoint_types=1%7C1"
            + "&waypoint_names=ChargePoint+Charging+Station%7CEvie+Charging+Station"
            + "&waypoint_power_outputs_kw=6.6%7C350");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Output daya tidak diketahui

Jika nilai output daya tidak diketahui, biarkan slot waypoint_power_outputs_kw yang relevan kosong. Atau jika semua slot kosong, tidak perlu menentukan parameter waypoint_power_outputs_kw.

Tujuan secara berurutan:

1. SPKLU ChargePoint (lokasi: -32.9599188,151.6240806, output daya: tidak diketahui)

2. Port Macquarie NSW

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=Port+Macquarie+NSW"
            + "&waypoints=-32.9599188%2C151.6240806"
            + "&waypoint_types=1"
            + "&waypoint_names=ChargePoint+Charging+Station");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Menandai tujuan akhir sebagai SPKLU

Untuk menandai tujuan akhir sebagai SPKLU, tentukan parameter q_type, q_name, dan q_power_output_kw.

Tujuan secara berurutan:

1. Taronga Zoo, Sydney Australia

2. SPKLU ChargePoint (lokasi: -32.9599188,151.6240806, output daya: tidak diketahui)

3. Stasiun Pengisian Daya Evie (lokasi: -31.9432539,152.4699808, output daya: 350 kW)

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=-31.9432539,152.4699808&q_type=1&q_name=Evie+Charging+Station&q_power_output_kw=350"
            + "&waypoints=Taronga+Zoo%2C+Sydney+Australia%7C-32.9599188%2C151.6240806"
            + "&waypoint_types=0%7C1"
            + "&waypoint_names=%7CChargePoint+Charging+Station"
            + "&waypoint_power_outputs_kw=%7C");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Maksud tindakan

Maksud tindakan berikut dengan antarmuka tersedia: