API Tuyến đường đã được phát hành dưới dạng Bản dùng thử công khai (giai đoạn trước khi phát hành rộng rãi) vào tháng 9 năm 2022. Các 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 riêng dành cho dịch vụ của Google Maps Platform Terms. Để 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 một ứng dụng từ bản phát hành Bản dùng thử sang bản phát hành rộng rãi.
Các tính năng mới được thêm vào bản phát hành rộng rãi
Bản phát hành rộng rãi bổ sung các tính năng mới sau đây mà Bản dùng thử không 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 rộng rãi 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, {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 độ thì mới có thể tính toán tuyến đường.
Ngoài ra, chúng tôi đã thêm tính năng hỗ trợ tham số yêu cầu
regionCode, cho phép bạn chỉ định trả về kết quả đã mã hoá địa lý cho một khu vực địa lý cụ thể.-
Plus Codes giống như địa chỉ đường phố dành 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ố nhà, Plus Codes 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 khởi hành, điểm đến hoặc điểm dừng chân trung gian) được chỉ định là chuỗi địa chỉ hoặc Plus Code, 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 là mã địa điểm hoặc toạ độ vĩ độ/kinh độ sẽ bị bỏ qua.
Các thay đổi đối với tính năng hiện có trong Bản dùng thử
Giờ đây, bạn phải bật rõ ràng các tính năng sau trong bản phát hành rộng rãi bằng cách thêm trường mảng extraComputations mới vào yêu cầu:
Trong bản phát hành Bản dùng thử, 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 thực hiện cả hai việc sau:
- Đặt tham số yêu cầu mảng
extraComputationsmớ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ề phí cầu đường)
Các trường sau đây 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ề 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(Tình trạng giao thông trên đường nhiều đoạn thẳng)routes.legs.travelAdvisory.speedReadingIntervals(Tình trạng giao thông trên đường nhiều đoạn thẳng)
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 tình trạng giao thông trên đường nhiều đoạn thẳng, bạn phải đặt trường mảng yêu cầu mới extraComputations để đưa một hoặc nhiều giá trị sau vào:
Để nhận thông tin về phí cầu đường, hãy đặt trường mảng mới
extraComputationsthành"TOLLS".Để nhận thông tin về mức tiêu thụ nhiên liệu, hãy đặt trường
extraComputationsmảng mới thành"FUEL_CONSUMPTION".Để nhận thông tin về tình trạng giao thông trên đường nhiều đoạn thẳng, hãy đặt trường mảng mới
extraComputationsthành"TRAFFIC_ON_POLYLINE".