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

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

Phần này mô tả cách di chuyển ứng dụng từ Bản dùng thử sang bản phát hành GA.

Các tính năng mới được thêm 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 xem trước:

  • Cùng với mã địa điểm và vĩ độ/kinh độ, giờ đây bạn có thể chỉ định 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 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, 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ố của những người hoặc địa điểm không có địa chỉ thực. Thay vì địa chỉ kèm theo tên và số, Plus Codes dựa trên vĩ độ và kinh độ, đồng thời 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 gốc, đích đến hoặc điểm tham chiếu 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í đó. Các vị trí trong yêu cầu được chỉ định dưới dạng mã địa điểm hoặc vĩ độ/độ dài sẽ bị bỏ qua.

Thay đổi đối với các tính năng Xem trước hiện có

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

Trong Bản dùng thử, bạn đã sử dụng một 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.
  • Thiết lập 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 sẽ không còn xuất hiện trong các phản hồi củacomputeRouteMatrix trừ phi bạn bật các trường này một cách rõ ràng bằng cách đặt extraComputations:

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

Các trường sau sẽ không còn xuất hiện trong phản hồi củacomputeRoutes trừ phi được bật một cách rõ ràng bằng cách đặt extraComputations:

  • routes.legs.travelAdvisory.tollInfo(Thông tin về phí cầu đường)
  • routes.travelAdvisory.tollInfo(Thông tin về phí cầu đường)
  • routes.travelAdvisory.fuelConsumptionMicroliters(Mức tiêu thụ nhiên liệu)
  • routes.travelAdvisory.speedReadingIntervals(Giao thông trên hình nhiều đường)
  • routes.legs.travelAdvisory.speedReadingIntervals(Giao thông trên hình nhiều đường)

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

Để nhận các trường phản hồi về thông tin phí cầu đường, mức tiêu thụ nhiên liệu hoặc giao thông trên một hình nhiều đường, 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: