Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Câu hỏi thường gặp

Chi tiết sản phẩm

Thông báo về Điều khoản dịch vụ của SDK Điều hướng phải được hiển thị như thế nào?

Ứng dụng của bạn phải triển khai một hộp thoại có thông báo về Điều khoản dịch vụ của SDK Điều hướng mà mỗi tài xế phải chấp nhận. Hộp thoại này cho phép người lái xe đồng ý với Điều khoản dịch vụ. Tệp văn bản của các điều khoản được cung cấp cùng với SDK Điều hướng.

Trong Android, hãy sử dụng phương thức NavigationApi.showTermsAndConditionsDialog để hiển thị hộp thoại chứa các điều khoản.

Trong iOS, hãy gọi GMSNavigationServices.showTermsAndConditionsDialogIfNeededWithCompanyName.

Tính năng hướng dẫn bằng giọng nói hỗ trợ những ngôn ngữ nào?

Mọi ngôn ngữ được Google Maps Mobile hỗ trợ đều tự động có sẵn cho SDK Điều hướng. Thiết bị có ngôn ngữ hệ thống mặc định và ứng dụng không thể thay đổi chế độ cài đặt đó; tuy nhiên, ứng dụng có quyền truy cập vào hơn 70 ngôn ngữ.

Hướng có được duy trì khi người lái xe thoát khỏi chế độ thao tác không?

Có. Trong Android, sau khi khởi động, LocationListener sẽ tiếp tục chạy trong nền. Ứng dụng của bạn tiếp tục điều chỉnh vị trí theo đường và duy trì hướng.

Trong iOS, để tiếp tục nhận thông tin cập nhật vị trí và hướng đi ở chế độ nền, hãy triển khai tính năng bám đường và đặt allowsBackgroundLocationUpdates thành YES.

Đường đa tuyến có xuất hiện khi bắt đầu hoặc thay đổi tuyến đường không?

Có. Khi một tuyến đường được tạo hoặc thay đổi, RouteChangeListener sẽ cung cấp các hình nhiều đường.

Người dùng ứng dụng có cần cài đặt Google Maps dành cho thiết bị di động không?

Không, Navigation SDK không yêu cầu cài đặt Google Maps Mobile trên thiết bị.

Navigation SDK có thể xác định bãi đỗ xe gần nhà hàng và các địa điểm yêu thích khác không?

Không, SDK chỉ đường hiện không cung cấp chức năng này.

Navigation SDK có cho biết hướng giao thông trong các làn đường khi đến gần điểm rẽ không?

Có. Hướng lưu lượng truy cập được cung cấp và hiển thị theo mặc định.

Vấn đề

Trong Xcode 12, ứng dụng không tạo bản dựng chính xác cho trình mô phỏng. Làm cách nào để khắc phục vấn đề này?

Để khắc phục vấn đề này, hãy mở phần Cài đặt bản dựng của dự án Xcode rồi thêm arm64 vào Excluded Architectures chỉ cho các bản dựng "Trình mô phỏng iOS".

Để biết thêm thông tin, hãy xem chuỗi bài viết sau trên StackOverflow.

GMSMapView không tải.

Nếu GMSMapView không tải:

Kiểm tra để đảm bảo NavSDK đã được bật trong Cloud Console.
Nếu bạn đã cài đặt SDK Điều hướng nhưng dự án của bạn không sử dụng API SDK Điều hướng, hãy xoá SDK này khỏi tệp nhị phân.

Mạng

Navigation SDK xử lý tình trạng kết nối kém như thế nào?: Navigation SDK lưu trước tuyến đường cho mỗi hành trình vào bộ nhớ đệm. Thông tin được lưu trước vào bộ nhớ đệm bao gồm thông tin định tuyến trong 15-20 phút và các tuyến đường thay thế trong trường hợp người lái xe đi chệch khỏi tuyến đường. SDK Điều hướng ước chừng vị trí bằng GPS và cảm biến của thiết bị.
Có chế độ ngoại tuyến không?: Không, SDK Điều hướng hiện không cung cấp chế độ ngoại tuyến; tuy nhiên, SDK này cung cấp thông tin được lưu trước vào bộ nhớ đệm cho một hành trình.

Dữ liệu

Tôi có thể truy xuất tất cả các điểm dừng/điểm đến trong một hành trình trước khi bắt đầu tuyến đường không?

Có. Trong Android, để truy xuất đường đi cho một tuyến đường, hãy gọi Navigator.getRouteSegments().

Trong iOS, hãy gọi GMSNavigator.routeLegs(read).

Có hướng dẫn từng chặng ở đầu tuyến đường không?

Có. Navigation SDK cung cấp danh sách các đoạn tuyến đường. Ngoài ra, người lái xe có thể vuốt qua thẻ chỉ đường trong tiêu đề để xem từng thao tác.

Làm cách nào để thông báo ETA cho người dùng ứng dụng?

Trong Android, hãy làm theo các bước sau để cung cấp thông tin về ETA cho người dùng ứng dụng:

Truy xuất thời gian và khoảng cách cho tất cả điểm tham chiếu bằng cách sử dụng Navigator.getTimeAndDistanceList().
Chuyển tiếp thông tin này đến ứng dụng khách như bạn làm với ETA của tài xế.

Trong iOS, hãy làm theo các bước sau để cung cấp thông tin về ETA cho người dùng ứng dụng:

Truy xuất các chặng trong hành trình bằng cách sử dụng Navigator.getRouteSegments().
Gọi GMSNavigator.timeToNextDestination cho mỗi chặng hành trình.
Chuyển tiếp thông tin thời gian đến ứng dụng khách như bạn làm với ETA của tài xế.

Có thể dùng RoadSnappedLocationProvider để lấy vị trí hiện tại của tài xế nếu tính năng chỉ đường không ở nền trước không?

Có. Trong Android, RoadSnappedLocationProvider chạy ở chế độ nền theo mặc định.

Trong iOS, để duy trì hoạt động của tính năng chỉ đường ở chế độ nền, hãy triển khai trình nghe cho GMSRoadSnappedLocationProviderListener và đặt thuộc tính allowsBackgroundLocationUpdates thành TRUE.

Navigation SDK có hỗ trợ tính năng khoanh vùng địa lý không?

Không. Trong bối cảnh chỉ đường, remainingTimeOrdistanceChangeListener có lợi thế hơn so với khoanh vùng địa lý. Hàng rào địa lý có thể không tính đến hình dạng đường và có thể không nằm ở chính giữa điểm chính xác mà tài xế đang di chuyển đến.

Bạn có thể ước chừng chức năng này bằng cách sử dụng remainingTimeOrdistanceChangeListener.

Đặt ngưỡng để xác định tần suất của lệnh gọi lại.
Kiểm tra khoảng cách còn lại đến điểm đến.

Ví dụ: nếu đặt ngưỡng là 100 m, bạn sẽ nhận được lệnh gọi lại khi khoảng cách đến đích đến thay đổi 100 m. Khi khoảng cách giảm, bạn có thể cập nhật ngưỡng này thành một giá trị nhỏ hơn và nhận được lệnh gọi lại thường xuyên hơn. Sau đó, hãy kiểm tra quãng đường còn lại để xác định xem bạn có đủ gần vị trí đón/trả khách hay không.

Trong iOS, hãy triển khai trình nghe GMSNavigatorListener.didUpdateRemainingDistance để quản lý khoảng cách giữa các thông báo.

Tôi có thể tắt thông báo khi ứng dụng Điều hướng ở chế độ nền không?

Có. Trong Android, hãy sử dụng Navigator.setHeadsUpNotificationEnabled để kiểm soát thông báo. Phương thức này có một đối số boolean. FALSE tắt thông báo; TRUE bật thông báo.

Trong iOS, hãy tắt thông báo ở chế độ nền cho các vị trí được điều chỉnh theo đường bằng cách đặt GMSRoadSnappedLocationProvider.allowsBackgroundLocationUpdates thành NO.

Để tắt tính năng xử lý trong nền cho các thông báo vị trí khác, hãy gọi GMSNavigator.sendsBackgroundNotifications(NO).

Tuỳ chỉnh giao diện người dùng

Tôi có thể mã hoá màu cho tuyến đường phù hợp nhất không?

Không. Hiện tại, chúng tôi chưa hỗ trợ tính năng mã hoá màu cho một lựa chọn tuyến đường cụ thể.

Navigation SDK có thể hiển thị thời gian đến dự kiến cho điểm đến cuối cùng không?

Có. Trong Android, hãy sử dụng các phương thức sau:

Truy xuất thời gian và khoảng cách cho tất cả điểm tham chiếu bằng cách sử dụng Navigator.getTimeAndDistanceList().
Ẩn ETA của điểm tham chiếu hiện tại bằng cách sử dụng NavigationFragment.setEtaCardEnabled(false).
Hiển thị thời gian đến dự kiến của điểm đến cuối cùng.

Trong iOS, hãy sử dụng các bước sau:

Gọi GMSNavigator.routeLegs(read).
Với chặng cuối, hãy gọi GMSNavigator.timeToNextDestination.
Ẩn ETA của điểm tham chiếu hiện tại bằng cách đặt MSMapView.settings.navigationFooterEnabled=NO thành FALSE.
Hiển thị thời gian đến dự kiến của điểm đến cuối cùng.

Làm cách nào để ẩn thông tin cập nhật về thời gian đến dự kiến?

Bạn có thể tắt thẻ ETA bằng các phương thức sau:

Trong Android, hãy sử dụng navigationView.setEtaCardEnabled(false).
Trong iOS, hãy sử dụng GMSMapView.settings.navigationFooterEnabled=NO.

Bạn có thể tuỳ chỉnh giao diện người dùng nào cho thẻ đầu trang và chân trang?

Trong Android, bạn sử dụng StylingOptions để đặt kiểu màu nền. Để ẩn hoặc hiện tiêu đề và chân trang, hãy sử dụng các hàm thành viên setHeaderEnabled và setFooterEnabled của NavigationFragment.

Trong iOS, hãy sử dụng GMSMapView.settings.navigationHeaderPrimaryBackgroundColor để đặt kiểu màu nền. Để ẩn hoặc hiện tiêu đề và chân trang, hãy sử dụng các thuộc tính navigationFooterEnabled và navigationHeaderEnabled của GMSUISettings.

Định tuyến

Tôi có thể cung cấp một tuyến đường cụ thể cho tài xế hoặc xoá các tuyến đường thay thế không?

Không. Theo mặc định, hệ thống sẽ cung cấp nhiều tuyến đường và ưu tiên tuyến đường nhanh nhất. Bạn có thể ảnh hưởng đến tuyến đường mặc định bằng cách thêm các lựa chọn ưu tiên, chẳng hạn như "tránh đường cao tốc và trạm thu phí" vào yêu cầu của bạn. Việc thêm điểm tham chiếu cũng ảnh hưởng đến tuyến đường.

Tôi có thể cho người dùng ứng dụng thấy một nhãn khác cho điểm đến so với vị trí điểm đến mặc định không?

Có. Trong Android, hãy tạo một Marker có tiêu đề tuỳ chỉnh cho điểm đến và vĩ độ/kinh độ. SDK điều hướng sẽ hiển thị tiêu đề tuỳ chỉnh và toạ độ trên NavigationMap.

Trong iOS, bạn tạo và hiển thị GMSMarker cho đích đến.

Tôi có thể sử dụng SDK chỉ đường để theo dõi các trường hợp đi chệch khỏi tuyến đường đã xác định không?

Có. Trong Android, hãy sử dụng Navigator.setRouteChangedListener để nhận thông báo khi tuyến đường thay đổi hoặc khi có tuyến đường mới được đề xuất:

Đăng ký một trình nghe để kiểm tra vị trí của thiết bị dọc theo tuyến đường bằng phương thức Navigator.setRouteChangedListener.
Thêm mã vào trình xử lý sự kiện gọi lại, onRouteChanged:
- Gửi tin nhắn cho người dùng ứng dụng kèm theo thông tin mới nhất về thời gian đến dự kiến và khoảng cách.
- Theo dõi vị trí của thiết bị.
- [không bắt buộc] Thêm chức năng khác mà ứng dụng của bạn yêu cầu để xử lý khi tài xế đi chệch khỏi tuyến đường đã chỉ định.

Trong iOS, hãy sử dụng GMSNavigator và trình nghe của lớp này để nhận thông báo khi tuyến đường thay đổi hoặc khi có tuyến đường mới được đề xuất:

Trên bộ điều khiển chế độ xem của bản đồ, hãy triển khai giao thức GMSNavigatorListener và giao thức GMSRoadSnappedLocationProviderListener.
Triển khai GMSNavigatorListener.navigatorDidChangeRoute.
Truy cập vào tuyến đường mới bằng cách sử dụng các thuộc tính routeLegs và currentRouteLeg của GMSNavigator.

Người lái xe có thể thoát khỏi chế độ đi theo chỉ dẫn mà không cần hoàn thành tuyến đường không?

Có. Trong Android, hãy gọi phương thức Navigator.stopGuidance() để dừng đi theo chỉ dẫn.

Trong iOS, hãy gọi GMSNavigator.clearDestinations.

Navigation SDK có hỗ trợ tính năng định tuyến và chỉ đường cho xe tải và xe cỡ lớn không?

Có. Với tính năng định tuyến xe lớn (LVR), bạn có thể truyền mã thông báo tuyến đường dành riêng cho xe tải do Routes API hoặc Route Optimization API tạo đến SDK Điều hướng. SDK này cung cấp tính năng chỉ đường từng chặng kèm theo chú thích về tuyến đường (chiều cao, trọng lượng, vật liệu nguy hiểm và các quy định hạn chế đối với xe tải) và duy trì hồ sơ vật lý của xe trong quá trình đổi tuyến đường linh động. Để biết thông tin chi tiết, hãy xem bài viết Đi theo tuyến đường dành cho xe lớn.

Trình mô phỏng

Trình mô phỏng có hỗ trợ thay đổi tuyến đường không?

Có. Trong Android, hãy gọi simulateLocationsAlongNewRoute để mô phỏng một hành trình có thay đổi tuyến đường. Phương thức simulateLocationsAlongExistingRoute bỏ qua các thay đổi đối với tuyến hiện có.

Trong iOS, hãy sử dụng GMSLocationSimulator.simulateAlongNewRouteToDestinations để mô phỏng một hành trình có thay đổi tuyến đường. Nếu không dự đoán được bất kỳ thay đổi nào về tuyến đường, bạn có thể sử dụng GMSLocationSimulator.simulateLocationsAlongExistingRoute hoặc GMSLocationSimulator.simulateAlongNewRouteToDestinations.

Quy trình công việc

Làm cách nào để đóng thông báo sau khi đóng một hoạt động có chứa mảnh điều hướng?

Thông báo chỉ đường vẫn hiển thị trong khi chỉ đường, khi hoạt động bị đóng. Khi xe đến điểm đến, tính năng chỉ đường sẽ dừng và thông báo sẽ biến mất.

Để xử lý các lượt nhấp vào thông báo, hãy sử dụng Navigator.startGuidance(intent resumeIntent). resume intent kích hoạt khi người dùng ứng dụng nhấp vào thông báo. Thông thường, Navigator.startguidance(getIntent()) được gọi từ Hoạt động chính, giúp gọi lại Hoạt động khi người dùng ứng dụng nhấp vào thông báo.

Dịch vụ hỗ trợ di chuyển

Cách sử dụng SDK Điều hướng có gì khác biệt đối với khách hàng của Dịch vụ di động?

Dịch vụ di chuyển của Google Maps Platform cung cấp một tập hợp các API và SDK để giúp hỗ trợ nhu cầu của doanh nghiệp trong lĩnh vực vận tải và hậu cần. Đối với khách hàng sử dụng Dịch vụ di chuyển, SDK Điều hướng thường được dùng kết hợp với các dịch vụ liên quan để tối ưu hoá tuyến đường, điều phối, theo dõi nhiệm vụ, phân tích đội xe, v.v. Navigation SDK cũng được tính phí theo cách khác đối với khách hàng sử dụng Dịch vụ di chuyển. Để biết thêm thông tin, hãy xem tài liệu về Dịch vụ di chuyển.

Sản phẩm di động chỉ dành cho một số khách hàng. Hãy liên hệ với người đại diện bán hàng của bạn để biết thêm thông tin.

Làm cách nào để biết tôi có phải là khách hàng của Dịch vụ di chuyển hay không?

Nếu bạn không chắc chắn liệu mình có đang triển khai SDK Điều hướng với tư cách là khách hàng của Dịch vụ di động hay không, hãy tìm lệnh gọi ReportBillableEvent trong mã của bạn. Chỉ khách hàng của Dịch vụ di chuyển mới được gọi phương thức ReportBillableEvent.

Navigation SDK được tính phí như thế nào đối với khách hàng sử dụng Dịch vụ di chuyển?

Đối với khách hàng sử dụng Dịch vụ di chuyển, thông tin thanh toán và giá của SDK Điều hướng phụ thuộc vào thoả thuận dịch vụ mà bạn ký kết với Google Maps Platform. Để biết thông tin về cách xác minh rằng việc triển khai Dịch vụ di động của bạn đang được tính phí chính xác, hãy xem phần Xác thực thông tin thanh toán. Để biết thêm thông tin về việc thanh toán cho Dịch vụ di chuyển, hãy liên hệ với người đại diện bán hàng của bạn.

Những API nào của SDK Điều hướng chỉ dành cho khách hàng sử dụng Dịch vụ di động?

Có một số API trong SDK Điều hướng chỉ dành cho khách hàng sử dụng Dịch vụ di động, những người được Google tính phí theo từng giao dịch. Nếu bạn không phải là khách hàng của Dịch vụ di chuyển, thì các phương thức sau đây sẽ không hoạt động:

Nếu là khách hàng của Dịch vụ di chuyển, tôi có thể sử dụng cách triển khai SDK Điều hướng không thuộc Dịch vụ di chuyển không?

Có, khách hàng của Dịch vụ di chuyển có thể sử dụng cả cách triển khai Dịch vụ di chuyển và cách triển khai không phải Dịch vụ di chuyển của SDK Điều hướng. Tuy nhiên, bạn chỉ có thể sử dụng một loại phương thức triển khai trong một ứng dụng tại một thời điểm. Bạn cũng cần tạo một dự án Google Cloud, tài khoản thanh toán và khoá API mới, tách biệt với những dự án, tài khoản và khoá mà bạn dùng cho việc triển khai Dịch vụ di chuyển. Để biết thêm thông tin, hãy xem tổng quan về cách thiết lập SDK Điều hướng.

Để biết thêm thông tin về cách sử dụng SDK Điều hướng không phải của Dịch vụ di chuyển, bao gồm cả việc di chuyển ứng dụng từ loại triển khai này sang loại triển khai khác, hãy liên hệ với nhân viên phụ trách khách hàng của Google.

Lưu ý: Nếu bạn không phải là khách hàng của Dịch vụ di chuyển và muốn tìm hiểu thêm về tập hợp API và SDK của Dịch vụ di chuyển, hãy liên hệ với nhóm bán hàng của Google Maps Platform.