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

Phát hành API Tuyến đường 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) vào tháng 9 năm 2022. Các 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à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 phần mô tả về giai đoạn phát hành.

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 mà không có trong Bản xem trước:

  • 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ỉ ("pizza, IL" hoặc "Darwin, NT, Úc")

      Chuỗi địa chỉ thường là cách người dùng nhập địa chỉ. Tuy nhiên, {product_name} trước tiên 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 đã hỗ trợ thêm cho tham số yêu cầu regionCode, cho phép bạn chỉ định trả về các kết quả được mã hoá địa lý cho một khu vực địa lý cụ thể.

    • Mã cộng

      Plus Code là địa chỉ đường phố cho những người hoặc địa điểm không có địa chỉ thực. Thay vì địa chỉ có tên đường và số, Plus Code 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 gốc, điểm đến hoặc điểm tham chiếu trung gian) được chỉ định làm chuỗi địa chỉ hoặc dưới dạng Mã cộng, API sẽ thực hiện việc 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 làm mã địa điểm hoặc toạ độ vĩ độ/kinh độ sẽ bị bỏ qua.

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

Bây giờ, bạn phải bật các tính năng sau một cách rõ ràng trong GA bằng cách thêm trường extraComputations của 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. Bây giờ, bạn phải làm cả hai việc sau:

  • Đặ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 (field mask) để 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 được đưa vào trong SuperRouteMatrix phản hồi trừ phi bạn bật rõ ràng bằng cách đặt extraComputations:

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

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

  • routes.legs.travelAdvisory.tollInfo(Thông tin cầu đường)
  • routes.travelAdvisory.tollInfo(Thông tin cầu đường)
  • routes.travelAdvisory.fuelConsumptionMicroliters(Mức tiêu thụ nhiên liệu)
  • routes.travelAdvisory.speedReadingIntervals(Giao thông trên đường nhiều đường)
  • routes.legs.travelAdvisory.speedReadingIntervals(Giao thông trên đường 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 cầu đường, mức tiêu thụ nhiên liệu hoặc tình hình 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: