Khắc phục sự cố

Lỗi

Trong trường hợp xảy ra lỗi, hệ thống sẽ trả về nội dung phản hồi lỗi định dạng chuẩn và mã trạng thái HTTP sẽ được đặt thành trạng thái lỗi.

Phản hồi chứa một đối tượng có một đối tượng error duy nhất với các đối tượng sau khoá:

  • code: Trạng thái này giống với trạng thái HTTP của phản hồi.
  • message: Mô tả ngắn về lỗi.
  • status: Mã trạng thái cho biết bản chất của lỗi.

Ví dụ: việc gửi tham số placeId không hợp lệ sẽ trả về kết quả sau lỗi:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

Các lỗi có thể xảy ra bao gồm:

Trạng thái Thông điệp Khắc phục sự cố
400 INVALID_ARGUMENT Khoá bạn đã cung cấp không hợp lệ. Khoá API của bạn không hợp lệ hoặc không có trong yêu cầu. Hãy đảm bảo rằng bạn đã bao gồm toàn bộ khoá và bạn đã đã bật API cho khoá này.
400 INVALID_ARGUMENT "\"đường dẫn\" tham số chứa giá trị không hợp lệ: ☃" Yêu cầu của bạn chứa các đối số không hợp lệ. Những nguyên nhân có thể nhất gây ra lỗi này là:
  • Đã xảy ra sự cố với tham số path của bạn.
    Vui lòng đảm bảo bạn có ít nhất 1 và không quá 100 . Mỗi điểm phải là một cặp số được phân tách bằng dấu phẩy, chẳng hạn như: 48.409114,-123.369158. Điểm phải là phân tách bằng dấu gạch đứng: "|".
  • Yêu cầu của bạn có chứa placeId không hợp lệ.
  • Yêu cầu của bạn bao gồm cả placeIdpath. Bạn chỉ có thể chỉ định một trong các thông số này cho từng yêu cầu.

Lỗi này sẽ không được trả về nếu truyền placeId cho đường không còn tồn tại hoặc cho một địa điểm không phải là đường.

403 PERMISSION_DENIED Yêu cầu chưa đăng ký đã bị chặn. Vui lòng đăng ký bằng Google Developers Bảng điều khiển. Yêu cầu đã bị từ chối vì một hoặc nhiều lý do sau:
  • Khoá API bị thiếu hoặc không hợp lệ.
  • Bạn chưa bật tính năng thanh toán trên tài khoản của mình.
  • Đã vượt quá giới hạn mức sử dụng tự đặt.
  • Phương thức thanh toán bạn cung cấp không còn hợp lệ (ví dụ: thẻ tín dụng đã hết hạn).

Để sử dụng các sản phẩm trên Nền tảng Google Maps, bạn phải bật tính năng thanh toán trên tài khoản của bạn và tất cả các yêu cầu phải bao gồm một khoá API hợp lệ. Để khắc phục vấn đề này, hãy thực hiện các bước sau:

404 NOT_FOUND HTTPS là bắt buộc cho dịch vụ này. Đảm bảo rằng bạn đang gửi yêu cầu đến https://roads.googleapis.com/ trở về http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED Yêu cầu đã bị điều tiết do đã đạt đến giới hạn số lượng yêu cầu của dự án. Bạn đã vượt quá giới hạn yêu cầu mà bạn đã thiết lập trong Bảng điều khiển Google Cloud Platform. Giới hạn này thường được đặt là số yêu cầu mỗi ngày, số yêu cầu trong mỗi 100 giây và số yêu cầu trong mỗi 100 giây trên mỗi người dùng. Bạn nên định cấu hình giới hạn này để ngăn chặn một hoặc một nhóm nhỏ người dùng không làm hết hạn mức hàng ngày mà vẫn cho phép hợp lý quyền truy cập cho tất cả người dùng. Xem bài viết Giới hạn mức sử dụng API để định cấu hình các giới hạn này.

Thuật toán thời gian đợi luỹ thừa

Khi yêu cầu không thành công, bạn nên đảm bảo rằng bạn thử lại yêu cầu bằng hàm mũ thời gian đợi. Ví dụ: nếu yêu cầu không thành công một lần, hãy thử lại sau một giây, nếu lại thất bại, hãy thử lại sau 2 giây, sau đó là 4 giây, v.v. Chiến dịch này đảm bảo rằng các yêu cầu bị hỏng hoặc lỗi trên quy mô rộng không làm hỏng vì nhiều máy khách cố gắng thử lại yêu cầu thật nhanh chóng.

Câu hỏi thường gặp về cách khắc phục sự cố

Vấn đề về hoạt động triển khai

Tôi nên lấy mẫu vị trí xe của mình với tần suất nào?
Bạn nên tiến hành ghi lại mỗi 1 đến 10 giây để có được kết quả nhanh chóng và chất lượng cao.
Có giới hạn nào về số điểm tôi có thể gửi cho mỗi truy vấn không?
Có, một truy vấn có thể có tối đa 100 điểm.
Tôi nên sử dụng mức độ chính xác nào để lưu trữ vĩ độ/kinh độ đã chụp của tôi bắt cặp?
Để đảm bảo đường đi theo đúng đường đi ở tất cả các mức thu phóng, ngay cả mức thu phóng tối đa, bạn nên lưu trữ cặp vĩ độ/kinh độ được chụp nhanh tại 7 số thập phân của độ chính xác.
Tôi có thể sử dụng hình nhiều đường được mã hoá để hiển thị đường dẫn được không?
Nhiều đường đã mã hoá chỉ có độ chính xác là 5 chữ số thập phân, dẫn đến sai số khoảng 2 mét. Do đó, hình nhiều đường được mã hoá không phù hợp nếu bạn muốn đường đi theo đường chính xác ở mức thu phóng cao cấp độ.

Các vấn đề thường gặp

Một số điểm không được chốt hoặc tôi có khoảng trống trên đường dẫn nhanh. Làm cách nào để Tôi có sửa lỗi này không?
  • Nếu bạn lấy mẫu điểm của mình tại các khoảng thời gian được tính giờ, hãy đảm bảo điểm của bạn được lấy mẫu theo khoảng thời gian ngắn hơn (1-10 giây một lần). Nếu sử dụng khoảng thời gian dài hơn (ví dụ: 60 giây), thuật toán bám theo đường có thể không thể xác định đường đi với độ chính xác đủ cao.
  • Nếu bạn tự nhấp vào bản đồ để tạo điểm, thật dễ dàng tạo đường dẫn có ít điểm hoặc điểm thưa mà thuật toán chụp nhanh sẽ không xử lý tốt. Thuật toán chụp nhanh hoạt động hiệu quả nhất đối với các điểm lại gần nhau. Hãy thử ứng dụng Bám theo Bản minh hoạ về đường hoặc sử dụng Đường trình kiểm tra để kiểm thử đường dẫn của bạn.
Tại sao các đường thẳng của tôi bị lởm chởm hoặc hơi lệch khỏi mặt đường khi tôi phóng to?
  • Bạn có đang cắt bớt độ chính xác của các cặp vĩ độ/kinh độ được chụp lại không trước khi hiển thị không? Lưu trữ các cặp vĩ độ/kinh độ được cố định tại khi độ chính xác dưới 7 chữ số thập phân sẽ gây ra lỗi về độ chính xác khi đường đi bị chụp sẽ được hiển thị trên bản đồ.
  • Bạn có đang sử dụng hình nhiều đường được mã hoá không? Cắt bớt hình nhiều dòng được mã hoá cặp vĩ độ/kinh độ đến 5 chữ số thập phân, gây ra lỗi vài mét, dẫn đến các đường thẳng lệch hoặc hơi lệch so với đường ở mức thu phóng cao.

Nếu không có trường hợp nào ở trên, các ô bản đồ có thể đã được cập nhật khiến chúng không đồng bộ với chỉ số đường được sử dụng cho chụp nhanh. Nếu chỉ có một vài truy vấn của bạn bị ảnh hưởng thì đây có thể là nguyên nhân. Vì Google Maps được cập nhật thường xuyên nên đôi khi điều này có thể xảy ra, và có thể xảy ra thường xuyên hơn nếu bạn thường xuyên xem các đường dẫn cũ trên bản đồ (ví dụ: ví dụ: đường dẫn đã bị chụp nhanh vài tuần trước). Để có hình ảnh tối ưu, bạn nên chụp lại các đường dẫn cũ ngay trước khi hiển thị chúng trên bản đồ, để giảm thiểu sự không nhất quán giữa các ô bản đồ và chỉ mục đường được sử dụng để chụp nhanh.

Điều gì có thể khiến giới hạn tốc độ cho đường X hiển thị không chính xác?
Giới hạn tốc độ xuất phát từ một số nguồn có mức độ chính xác và phạm vi khác nhau. Nếu bạn tìm thấy một mẫu, chẳng hạn như giới hạn tốc độ cho một loại đường cụ thể hoặc trong một khu vực cụ thể liên tục không chính xác, vui lòng thực hiện các bước sau để cho chúng tôi biết:
  1. Mở Google Maps trên máy tính để bàn của bạn HOẶC ứng dụng Google Maps cho Android.
  2. Mở trình đơn bên trái.
  3. Chọn Gửi ý kiến phản hồi. Lưu ý: bạn có thể được nhắc đăng nhập.
  4. Chọn Chỉnh sửa bản đồ.
  5. Chọn đoạn đường bạn muốn chỉnh sửa.
  6. Chọn Tiếp theo.
  7. Trong mục "Khác" , hãy biểu thị rằng giới hạn tốc độ không chính xác đối với đường đó.
  8. Chọn Gửi.
Bạn cũng có thể báo cáo các vấn đề khác tại đây (ví dụ: nếu đường có tên không chính xác, được vẽ không chính xác, bị đóng hoặc riêng tư).
Tại sao đường đi gấp của tôi lại là những góc cắt thay vì đi theo đường chính?
Để khắc phục vấn đề này, hãy kiểm tra các mục sau:
  • Hãy nhớ đặt tham số interpolate thành true.
  • Kiểm tra để đảm bảo các điểm dữ liệu ban đầu của bạn được lấy mẫu ở khoảng thời gian đủ gần (1-10 giây/lần).
Tại sao tôi nhận được nhiều đoạn đường được trả về trong đường dẫn bị tắc cho một đường không có thay đổi giới hạn tốc độ?
Khi tham số interpolate được đặt thành true, truy vấn bám theo đường trả về một hình nhiều đường dọc theo con đường quanh các góc, đường cong và đường vòng. Nếu đường cong, nhiều đoạn đường được trả về ngay cả khi giới hạn tốc độ không thay đổi, để tạo một hình nhiều đường sát hình học của đường.