Di chuyển từ bản phát hành Xem trước

Routes API được phát hành dưới dạng Bản dùng thử công khai (trước khi phát hành công khai) vào tháng 9 năm 2022. Sản phẩm/dịch vụ ở giai đoạn trước khi phát hành rộng rãi tuân theo Điều khoản dành riêng cho dịch vụ của Nền tảng Google Maps. Để biết thêm thông tin, hãy xem nội dung mô tả về giai đoạn ra mắt.

Phần này mô tả cách di chuyển một ứng dụng từ bản phát hành Xem trước sang bản phát hành GA.

Thêm tính năng mới vào bản phát hành GA

Bản phát hành GA bổ sung các tính năng mới sau đây không có trong Bản dùng thử:

  • Cùng với mã địa điểm và toạ độ vĩ độ/kinh độ, giờ đây, bạn có thể chỉ định một vị trí trong bản phát hành GA bằng cách sử dụng:

    • Chuỗi địa chỉ ("Chicago, IL" hoặc "Darwin, NT, Australia")

      Chuỗi địa chỉ thường là cách người dùng nhập địa chỉ. Tuy nhiên, trước tiên, {product_name} phải mã hoá địa lý chuỗi địa chỉ nội bộ để chuyển đổi chuỗi địa chỉ đó thành toạ độ vĩ độ/kinh độ trước khi có thể tính toán tuyến đường.

      Ngoài ra, chúng tôi đã thêm tính năng hỗ trợ cho tham số yêu cầu regionCode. Tính năng này cho phép bạn chỉ định trả về kết quả được mã hoá địa lý cho một khu vực địa lý cụ thể.

    • Plus Code

      Plus Code giống như địa chỉ đường phố cho những người hoặc địa điểm không có địa chỉ thực tế. Thay vì địa chỉ có tên đường và số nhà, Mã cộng được dựa trên vĩ độ và kinh độ, đồng thời được hiển thị dưới dạng số và chữ cái.

  • Phản hồi tính toán tuyến đường hiện chứa mảng geocodingResults. Đối với mọi vị trí trong yêu cầu (điểm xuất phát, điểm đến hoặc điểm trung gian) được chỉ định dưới dạng chuỗi địa chỉ hoặc Mã cộng, API sẽ thực hiện tra cứu mã địa điểm. Mỗi phần tử của mảng này chứa mã địa điểm tương ứng với một vị trí cùng với siêu dữ liệu bổ sung về vị trí đó. Hệ thống sẽ bỏ qua các vị trí trong yêu cầu được chỉ định dưới dạng mã địa điểm hoặc toạ độ vĩ độ/kinh độ.

Các thay đổi đối với các tính năng Bản dùng thử hiện có

Giờ đây, bạn phải bật rõ ràng các tính năng sau trong GA bằng cách thêm trường extraComputations mảng mới vào yêu cầu:

Trong bản phát hành xem trước, bạn đã sử dụng mặt nạ trường để chỉ định trả về thông tin cho các tính năng này trong phản hồi. Giờ đây, bạn phải:

  • Đặt tham số yêu cầu mảng extraComputations mới để bật các tính năng này.
  • Đặt mặt nạ trường để chỉ định trả về thông tin trong phản hồi.

Bạn cần biết điều gì?

Các trường sau đây sẽ không còn được đưa vào phản hồi computeRouteMatrix trừ phi bạn bật rõ ràng bằng cách đặt extraComputations:

  • travelAdvisory.tollInfo (Thông tin về đường thu phí)

Các trường sau sẽ không còn được đưa vào phản hồi computeRoutes trừ phi bạn bật rõ ràng bằng cách đặt extraComputations:

  • routes.legs.travelAdvisory.tollInfo(Thông tin về đường thu phí)
  • routes.travelAdvisory.tollInfo(Thông tin về đường thu phí)
  • routes.travelAdvisory.fuelConsumptionMicroliters(Mức tiêu thụ nhiên liệu)
  • routes.travelAdvisory.speedReadingIntervals(Lưu lượng truy cập trên một đường đa tuyến)
  • routes.legs.travelAdvisory.speedReadingIntervals(Lưu lượng truy cập trên một đường đa tuyến)

Việc bạn cần làm

Để nhận các trường phản hồi cho thông tin về phí cầu đường, mức tiêu thụ nhiên liệu hoặc lưu lượng truy cập trên một đường đa tuyến, bạn phải đặt trường mảng yêu cầu mới, extraComputations, để bao gồm một hoặc nhiều giá trị sau: