Ý định của Google Maps dành cho Android Automotive

Thông qua các ý định của Android, bạn có thể khởi chạy chế độ chỉ đường trong Google Maps cho Android Automotive.

Lưu ý: Việc sử dụng các API tương tác với bên thứ ba (tương tác với các dịch vụ của Google) phải tuân thủ Điều khoản dịch vụ của API Google. Đảm bảo ứng dụng của bạn tuân thủ tất cả các chính sách hiện hành của Google.

Tổng quan

Trang này mô tả các ý định mà bạn có thể sử dụng với Google Maps cho Android Automotive. Để biết tài liệu chi tiết dành cho nhà phát triển Android, hãy xem các tài liệu sau:

• Ý định và bộ lọc ý định
• Các ý định thường dùng trên nền tảng Android

Yêu cầu về ý định

Để chạy Google Maps cho Android Automotive bằng một ý định, trước tiên, bạn phải tạo một đối tượng Intent, chỉ định thao tác, URI và gói của đối tượng đó.

• Hành động. Tất cả các ý định của Google Maps đều được gọi dưới dạng một thao tác Xem, ACTION_VIEW.

• URI. Các ý định của Google Maps sử dụng các chuỗi được mã hoá URI để chỉ định một hành động đã chọn, cùng với một số dữ liệu để thực hiện hành động đó.

• Gói. Việc gọi setPackage("com.google.android.apps.maps") đảm bảo rằng ứng dụng Google Maps dành cho Android xử lý Intent. Nếu bạn không đặt gói, hệ thống sẽ xác định những ứng dụng có thể xử lý Ý định. Nếu có nhiều ứng dụng, có thể bạn sẽ được hỏi muốn dùng ứng dụng nào.

Sau khi tạo Intent, bạn có thể yêu cầu hệ thống khởi chạy ứng dụng liên quan theo một số cách. Một phương thức phổ biến là truyền Intent đến phương thức startActivity(). Hệ thống sẽ khởi chạy ứng dụng cần thiết (trong trường hợp này là Google Maps) và bắt đầu Activity tương ứng.

// 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);

Nếu hệ thống không xác định được ứng dụng có thể phản hồi Intent, thì ứng dụng của bạn có thể gặp sự cố. Vì lý do này, trước tiên, hãy xác minh rằng một ứng dụng nhận đã được cài đặt trước khi bạn trình bày một trong những ý định này cho người dùng.

Để xác minh rằng một ứng dụng có thể nhận ý định, hãy gọi resolveActivity() trên đối tượng Intent của bạn. Nếu kết quả không rỗng, thì có ít nhất một ứng dụng có thể xử lý ý định và bạn có thể gọi startActivity() một cách an toàn. Nếu kết quả là giá trị rỗng, bạn không nên sử dụng ý định và nếu có thể, hãy tắt tính năng gọi ý định.

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

Ví dụ: để chạy chế độ chỉ đường từng chặng đến Taronga Zoo ở Sydney, bạn có thể sử dụng mã sau:

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);
}

Chuỗi truy vấn được mã hoá URI

Tất cả các chuỗi được truyền đến các ý định của Google Maps đều phải được mã hoá URI. Ví dụ: chuỗi "1st & Pike, Seattle" sẽ trở thành 1st%20%26%20Pike%2C%20Seattle. Bạn có thể mã hoá dấu cách trong chuỗi bằng %20 hoặc thay thế bằng dấu cộng (+).

Bạn có thể sử dụng phương thức android.net.Uri encode() để mã hoá các chuỗi. Ví dụ:

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

Hiển thị bản đồ

Sử dụng ý định geo: để hiển thị bản đồ tại một vị trí và mức thu phóng cụ thể. Ví dụ:

geo:latitude,longitude?z=zoom

Tham số

• latitude và longitude đặt điểm trung tâm của bản đồ.

• z (không bắt buộc) đặt mức thu phóng ban đầu của bản đồ. Phạm vi giá trị được chấp nhận là từ 0 (toàn thế giới) đến 21 (các toà nhà riêng lẻ). Giới hạn trên có thể thay đổi tuỳ thuộc vào dữ liệu bản đồ có sẵn tại vị trí đã chọn.

Ví dụ

// 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);

Tìm kiếm vị trí

Sử dụng ý định này để hiển thị cụm từ tìm kiếm trong một khung hiển thị được chỉ định:

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

Tham số

Ngoài các tham số dùng để hiển thị bản đồ, Tìm kiếm còn hỗ trợ tham số này:

• q xác định những địa điểm cần làm nổi bật trên bản đồ. Tham số q là tham số bắt buộc đối với tất cả các yêu cầu Tìm kiếm. Nó chấp nhận một vị trí dưới dạng tên địa điểm hoặc địa chỉ. Chuỗi phải được thoát URL, vì vậy, một địa chỉ như "City Hall, New York, NY" phải được chuyển đổi thành City+Hall%2CNew+York%2CNY.

Lưu ý: Nếu URI ý định được chỉ định bằng tham số q geo:0,0?q=query và truy vấn trả về một giá trị duy nhất, thì kết quả truy vấn sẽ tự động được đặt làm đích đến.

Kết quả tìm kiếm thiên về toạ độ

Khi tìm kiếm một vị trí rất cụ thể, bạn không nhất thiết phải có vĩ độ và kinh độ nếu đã đưa vào tham số q. Tuy nhiên, nếu không biết địa chỉ chính xác hoặc cụm từ tìm kiếm không rõ ràng, bạn có thể cố gắng điều chỉnh kết quả tìm kiếm bằng cách chỉ định một toạ độ. Ví dụ: khi thực hiện tìm kiếm địa chỉ cho "Đường Main", bạn có thể nhận được quá nhiều kết quả:

// 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);

Việc thêm vĩ độ và kinh độ vào URI theo ý định sẽ thiên về kết quả cho một khu vực cụ thể:

// 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);

Tìm dọc theo tuyến đường

Nếu một ý định tìm kiếm geo:latitude,longitude?q=query được gửi trong quá trình điều hướng, thì ý định đó sẽ kích hoạt một lượt tìm kiếm dọc theo tuyến đường và vĩ độ cũng như kinh độ sẽ bị bỏ qua.

Tìm kiếm danh mục được xác định trước

Để hỗ trợ tích hợp với xe, Google Maps trong ô tô hỗ trợ một ý định hiển thị các danh mục được xác định trước sau đây:

Danh mục	Mã hoá danh mục ý định
Trạm xăng	gas_station
Nhà hàng	restaurant
Quán cà phê	cafe
Bãi đỗ xe	parking
Trạm sạc xe điện	electric_vehicle_charging_station

Ý định về danh mục có dạng geo:lat,lng?c=category.

Sử dụng c=<pre-defined category> bất kể chế độ cài đặt ngôn ngữ của người dùng. Google Maps hiển thị các kết quả có liên quan bằng ngôn ngữ phù hợp cho danh mục này. Ví dụ:

// 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);

Tìm kiếm theo danh mục khác

Nếu bạn truyền một cụm từ tìm kiếm chung (chẳng hạn như "nhà hàng" hoặc "quán cà phê") theo ngôn ngữ của người dùng, thì Google Maps cho Android Automotive sẽ tìm kiếm các trang thông tin doanh nghiệp phù hợp với tiêu chí. Nếu một vĩ độ và kinh độ cụ thể được cung cấp trong ý định geo:, thì nội dung tìm kiếm sẽ tập trung vào vị trí đó. Nếu bạn không chỉ định vị trí (ví dụ: geo:0,0), Google Maps sẽ cố gắng tìm các trang thông tin doanh nghiệp ở gần. Ví dụ:

// 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);

Bạn có thể điều chỉnh thêm kết quả tìm kiếm bằng cách chỉ định một tham số thu phóng cùng với chuỗi truy vấn. Trong ví dụ sau, việc thêm mức thu phóng 10 sẽ cố gắng tìm nhà hàng ở cấp thành phố thay vì ở gần:

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);

Bắt đầu chế độ điều hướng theo từng chặng

Để biết tài liệu về cách khởi chạy chế độ chỉ đường từng chặng trên các thiết bị Android khác, hãy xem phần Khởi chạy chế độ chỉ đường từng chặng trong Ý định của Google Maps cho Android.

Sử dụng ý định này để khởi chạy chế độ chỉ đường của Google Maps với chỉ đường từng chặng đến một hoặc nhiều địa chỉ hoặc toạ độ được chỉ định. Hướng dẫn đường đi luôn được cung cấp từ vị trí hiện tại của người dùng.

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

Tham số

Để khởi chạy chế độ chỉ đường, hãy dùng place hoặc q với waypoints (không bắt buộc). Để đánh dấu một điểm đến là trạm sạc (không bắt buộc), hãy xem phần Gửi kế hoạch chuyến đi bằng xe điện đến Google Maps.

• q đặt điểm cuối cho các cụm từ tìm kiếm chỉ đường. Đây có thể là vĩ độ và kinh độ hoặc địa chỉ được định dạng theo cụm từ tìm kiếm. Nếu đó là một chuỗi truy vấn trả về nhiều kết quả, thì kết quả đầu tiên sẽ được chọn.

• place đặt điểm đến là nhà riêng hoặc nơi làm việc. Chỉ định home để chuyển đến nhà riêng của người dùng và work để chuyển đến nơi làm việc của người dùng.

• avoid đặt các đối tượng mà tuyến đường nên cố gắng tránh. avoid là không bắt buộc và có thể được đặt thành một hoặc nhiều giá trị sau:

  • t cho phí cầu đường
  • h cho đường cao tốc
  • f cho phà

• waypoints chỉ định một hoặc nhiều địa điểm trung gian để định tuyến chỉ đường đến đích đến cuối cùng do q chỉ định. Bạn có thể chỉ định nhiều điểm tham chiếu bằng cách sử dụng ký tự gạch đứng (|) để phân tách các địa điểm, ví dụ: Berlin,Germany|Paris,France. Bạn có thể sử dụng bao nhiêu điểm tham chiếu tuỳ ý. Các điểm đánh dấu sẽ được thêm vào tuyến đường theo thứ tự như trong URL. Mỗi điểm tham chiếu có thể là một địa chỉ hoặc toạ độ vĩ độ và kinh độ được phân tách bằng dấu phẩy; và bạn có thể có địa chỉ cũng như toạ độ vĩ độ và kinh độ trong cùng một ý định. Các chuỗi phải được thoát URL, vì vậy, các điểm tham chiếu như "Berlin,Germany|Paris,France" phải được chuyển đổi thành Berlin%2CGermany%7CParis%2CFrance.

Ví dụ

Ý định này sẽ yêu cầu chỉ đường từng chặng đến Vườn thú Taronga ở Sydney, Úc:

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);

Nếu không muốn trả phí cầu đường hoặc đi phà, bạn có thể yêu cầu chỉ đường để cố gắng tránh những tình huống này:

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);

Hoặc nếu bạn muốn chuyển đến nhà riêng, hãy dùng:

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);

Để khởi chạy chế độ chỉ đường từng chặng đến 3 địa chỉ sau theo thứ tự, hãy truyền Vườn thú Taronga làm đích đến cuối cùng q, và Google Sydney và Nhà hát Opera Sydney làm điểm tham chiếu:

1. Google Sydney

2. Nhà hát Opera Sydney

3. Sở thú Taronga, Sydney, Úc

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);

Tương tự như q, bạn có thể biểu thị bất kỳ điểm tham chiếu nào bằng vĩ độ và kinh độ được phân tách bằng dấu phẩy thay vì địa chỉ. Ví dụ: để khởi chạy cùng một chế độ chỉ đường trong khi truyền vĩ độ và kinh độ cho Nhà hát Opera Sydney thay vì địa chỉ:

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);

Gửi kế hoạch chuyến đi bằng xe điện đến Google Maps

Sử dụng ý định điều hướng đến nhiều đích đến này để chỉ định một số đích đến làm điểm dừng sạc xe điện. Ý định này (mở rộng ý định có nhiều điểm đến) giúp người lái xe duy trì đủ lượng pin cho xe điện để đến đích bằng cách đồng bộ hoá thông tin về trạm sạc giữa các ứng dụng lập kế hoạch chuyến đi bằng xe điện và Google Maps.

Lưu ý: Để đánh dấu bất kỳ điểm tham chiếu nào là trạm sạc, tuyến đường phải chứa ít nhất một điểm tham chiếu và điểm đến cuối cùng.

Đối với trạm sạc, ý định của chuyến đi:

• Phải chứa tên và vĩ độ – kinh độ
• Có thể chứa công suất đầu ra (không bắt buộc) để dùng cho việc tính thời gian sạc

Google sử dụng tên trạm sạc và vĩ độ – kinh độ để tìm một địa điểm trạm sạc phù hợp nhằm hiển thị dữ liệu phong phú như loại giắc cắm, tổng số, tốc độ và tình trạng còn chỗ sạc theo thời gian thực, phương thức thanh toán được hỗ trợ và các điểm đến ưa thích (POI) của đơn vị lưu trữ. Ví dụ: chỉ đường lái xe trong bãi đỗ xe ngoài trời cho phần cuối cùng của chỉ đường, giờ mở cửa, điểm xếp hạng. Để đảm bảo các trạm sạc khớp với dữ liệu của Google, hãy sử dụng một <brand name> cụ thể, chẳng hạn như ChargePoint.

Tham số

Các tham số sau cho phép bạn chỉ định thông tin chi tiết về đích đến cuối cùng và mọi điểm tham chiếu, kể cả những điểm được chỉ định là trạm sạc xe điện.

Điểm đến cuối cùng

Để đặt trạm sạc làm đích đến cuối cùng, hãy sử dụng:

• q: Phải chứa giá trị vĩ độ và kinh độ của trạm sạc.
• q_type: 1 chỉ định rằng điểm đến cuối cùng là một trạm sạc.
• q_name: Tên của điểm đến cuối cùng. Bắt buộc nếu q_type là 1.
• q_power_output_kw: Một số thực cho công suất đầu ra của trạm sạc tính bằng kilowatt. Không bắt buộc.

Điểm tham chiếu

Đối với điểm đánh dấu, tất cả các tham số đều là các mảng giá trị song song, được phân tách bằng dấu gạch dọc (|) theo cùng thứ tự với điểm đánh dấu, không bao gồm đích đến cuối cùng. Sự không khớp về số lượng phần tử trong các mảng song song được coi là một ý định bị lỗi.

Để thêm một hoặc nhiều điểm tham chiếu trạm sạc, hãy sử dụng các tham số sau (tất cả đều không bắt buộc). Nếu một trong các điểm đến được đánh dấu là trạm sạc, thì tên điểm đến bắt buộc phải có cho điểm đến đó.

• waypoints: Danh sách các điểm tham chiếu như mô tả trong ý định chỉ đường từng chặng. Phải là giá trị vĩ độ và kinh độ cho các điểm tham chiếu của trạm sạc.

• waypoint_types: Các loại trên mỗi điểm tham chiếu được chỉ định dưới dạng một số. 0 là bất kỳ điểm dừng nào (giá trị mặc định) và 1 là trạm sạc.

• waypoint_names: Tên điểm tham chiếu. Đây là trường bắt buộc đối với trạm sạc.

• waypoint_power_outputs_kw: Số gấp đôi cho công suất của trạm sạc tính bằng kilowatt. Đối với trạm sạc, bạn có thể tuỳ ý chỉ định giá trị công suất đầu ra của điểm tham chiếu. Giá trị này được dùng làm phương án dự phòng nếu không tìm thấy trạm sạc phù hợp. Khe trống có nghĩa là không có giá trị nào được cung cấp.

Hành vi trong trải nghiệm người dùng (UX)

Đối với ý định về chuyến đi có nhiều điểm đến, màn hình tổng quan về tuyến đường sẽ xuất hiện nhưng chế độ chỉ đường không tự động bắt đầu.

Đối với một ý định được định dạng chính xác, Google Maps sẽ trình bày một màn hình tổng quan về tuyến đường cho chuyến đi. Màn hình tổng quan về tuyến đường sẽ hiển thị tất cả các điểm tham chiếu và đích đến cuối cùng từ ý định, cùng với các đề xuất sạc (nếu có).

Đối với mọi điểm tham chiếu hoặc điểm đến cuối cùng được đánh dấu là trạm sạc, Google Maps sẽ tìm kiếm một địa điểm phù hợp trong cơ sở dữ liệu của Google. Để đảm bảo thông tin tốt nhất có thể được hiển thị cho các trạm sạc:

• Nếu tìm thấy kết quả trùng khớp, Google Maps sẽ sử dụng dữ liệu của Google để hiển thị trạm sạc trong giao diện người dùng (UI) và đưa ra đề xuất sạc cho trạm sạc đó.

• Nếu không tìm thấy kết quả trùng khớp, dữ liệu được cung cấp trong ý định cho một trạm sạc (vĩ độ, kinh độ, tên và công suất đầu ra) sẽ được dùng để hiển thị trạm sạc này trong giao diện người dùng và đưa ra đề xuất sạc tại trạm sạc này.

Ví dụ

Các ví dụ sau đây minh hoạ cách tạo ý định cho nhiều tình huống lập kế hoạch chuyến đi bằng xe điện, bao gồm cả việc điều hướng qua nhiều trạm sạc và xử lý công suất đầu ra không xác định.

Chỉ đường đến điểm đến cuối cùng thông qua nhiều trạm sạc

Ý định sau đây sẽ điều hướng đến điểm đến cuối cùng là Port Macquarie, New South Wales, thông qua 2 trạm sạc là ChargePoint và Evie.

Đích đến theo thứ tự:

1. Trạm sạc ChargePoint (vị trí: -32.9599188,151.6240806, công suất đầu ra: 6,6 kW)

2. Trạm sạc Evie (vị trí: -31.9432539,152.4699808, công suất đầu ra: 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);

Công suất đầu ra không xác định

Nếu bạn không biết giá trị công suất đầu ra, hãy để trống vị trí liên quan của waypoint_power_outputs_kw. Hoặc nếu tất cả các ô đều trống, bạn không cần chỉ định tham số waypoint_power_outputs_kw.

Đích đến theo thứ tự:

1. Trạm sạc ChargePoint (vị trí: -32.9599188,151.6240806, công suất đầu ra: không xác định)

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);

Đánh dấu đích đến cuối cùng là trạm sạc

Để đánh dấu đích đến cuối cùng là trạm sạc, hãy chỉ định các tham số q_type, q_name và q_power_output_kw.

Đích đến theo thứ tự:

1. Sở thú Taronga, Sydney, Úc

2. Trạm sạc ChargePoint (vị trí: -32.9599188,151.6240806, công suất đầu ra: không xác định)

3. Trạm sạc Evie (vị trí: -31.9432539,152.4699808, công suất đầu ra: 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);

Ý định hành động

Bạn có thể sử dụng các ý định hành động sau đây có giao diện:

Thao tác	Mô tả
geo.action:?act=mute	Tắt tiếng tất cả hướng dẫn bằng giọng nói khi dò đường.
geo.action:?act=unmute	Bật chế độ chỉ đường bằng giọng nói.
geo.action:?act=show_traffic	Hiển thị các đường giao thông trên bản đồ.
geo.action:?act=hide_traffic	Ẩn các đường giao thông trên bản đồ.
geo.action:?act=show_satellite	Hiển thị hình ảnh vệ tinh trên bản đồ.
geo.action:?act=hide_satellite	Ẩn hình ảnh vệ tinh trên bản đồ.
geo.action:?act=show_alternates	Google Maps mở màn hình các tuyến đường thay thế (chỉ hoạt động trong khi bạn đang đi theo chỉ dẫn).
geo.action:?act=query_next_turn	Google Maps sẽ đọc lượt rẽ tiếp theo (chỉ hoạt động khi bạn đang tìm đường).
geo.action:?act=distance_to_next_turn	Google Maps đọc khoảng cách đến lượt rẽ tiếp theo (chỉ hoạt động khi bạn đang dò đường).
geo.action:?act=time_to_next_turn	Google Maps sẽ đọc thời gian đến lượt rẽ tiếp theo (chỉ hoạt động khi bạn đang chỉ đường).
geo.action:?act=distance_to_destination	Google Maps sẽ đọc khoảng cách đến đích đến (chỉ hoạt động khi bạn đang đi theo chỉ dẫn).
geo.action:?act=go_back	Google Maps quay lại màn hình trước đó trong giao diện người dùng.
geo.action:?act=query_current_road	Google Maps đọc tên đường hiện tại.
geo.action:?act=query_destination	Google Maps sẽ đọc điểm đến.
geo.action:?act=traffic_report	Google Maps đọc báo cáo giao thông.
geo.action:?act=clear_search_results	Google Maps đóng màn hình kết quả tìm kiếm (nếu màn hình này đang mở).
geo.action:?act=apply_electric_vehicle_connector_filter	Áp dụng bộ lọc loại giắc cắm cho kết quả tìm kiếm trạm sạc xe điện.
geo.action:?act=remove_electric_vehicle_connector_filter	Xoá bộ lọc loại giắc cắm cho kết quả tìm kiếm trạm sạc xe điện.
geo.action:?act=apply_electric_vehicle_payment_filter	Áp dụng bộ lọc thanh toán cho kết quả tìm kiếm trạm sạc xe điện.
geo.action:?act=remove_electric_vehicle_payment_filter	Xoá bộ lọc thanh toán cho kết quả tìm kiếm trạm sạc xe điện.
geo.action:?act=apply_electric_vehicle_fast_charging_filter	Áp dụng bộ lọc sạc nhanh cho kết quả tìm kiếm trạm sạc xe điện.
geo.action:?act=remove_electric_vehicle_fast_charging_filter	Xoá bộ lọc sạc nhanh cho kết quả tìm kiếm trạm sạc xe điện.
geo.action:?act=avoid_tolls	Nếu người dùng đang chỉ đường, hãy yêu cầu Google Maps tránh các tuyến đường có thu phí. Điều này có thể dẫn đến việc hệ thống định tuyến lại nếu tuyến đường hiện tại có thu phí.
geo.action:?act=allow_tolls	Nếu người dùng đang chỉ đường, hãy yêu cầu Google Maps cho phép các tuyến đường có thu phí. Điều này có thể dẫn đến việc định tuyến lại nếu việc cho phép đường thu phí giúp bạn có được một tuyến đường tốt hơn.
geo.action:?act=avoid_ferries	Nếu người dùng đang chỉ đường, hãy yêu cầu Google Maps tránh những tuyến đường có phà. Điều này có thể dẫn đến việc định tuyến lại nếu tuyến đường đang hoạt động hiện tại có phà.
geo.action:?act=allow_ferries	Nếu người dùng đang chỉ đường, hãy yêu cầu Google Maps cho phép các tuyến đường có phà. Điều này có thể dẫn đến việc định tuyến lại nếu việc cho phép phà dẫn đến việc có một tuyến đường tốt hơn.
geo.action:?act=avoid_highways	Nếu người dùng đang chỉ đường, hãy yêu cầu Google Maps tránh những tuyến đường có đường cao tốc. Điều này có thể dẫn đến việc định tuyến lại nếu tuyến đường đang hoạt động hiện tại có đường cao tốc.
geo.action:?act=allow_highways	Nếu người dùng đang chỉ đường, hãy yêu cầu Google Maps cho phép các tuyến đường có đường cao tốc. Điều này có thể dẫn đến việc định tuyến lại nếu việc cho phép đường cao tốc giúp bạn có được tuyến đường tốt hơn.
geo.action:?act=eta	Nếu người dùng đang đi theo chỉ dẫn, Google Maps sẽ nói thời gian dự kiến đến đích (ví dụ: 9:15).
geo.action:?act=time_to_destination	Nếu người dùng đang đi theo chỉ dẫn, Google Maps sẽ nói thời gian dự kiến đến đích (ví dụ: 15 phút).
geo.action:?act=exit_navigation	Thoát chế độ chỉ đường.
geo.action:?act=select_search_result&id=0	Nếu kết quả tìm kiếm xuất hiện trên màn hình (như trong hình ảnh đi kèm), thì thao tác này sẽ bắt đầu điều hướng đến kết quả thứ n dựa trên tham số mã nhận dạng được cung cấp. Lưu ý rằng chỉ mục này dựa trên 0 (tức là geo.action:?act=select_search_result&id=0 sẽ chọn kết quả đầu tiên trong danh sách).

Lưu ý: Bạn có thể sử dụng Trình mô phỏng Google Automotive để kiểm thử các ý định này.