Ô đường đi

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Tổng quan về Thẻ thông tin lộ trìnhThẻ thông tin bản đồ đường là thẻ thông tin hình ảnh dựa trên dữ liệu địa hình vectơ với kiểu bản đồ của Google. Dữ liệu này bao gồm đường, toà nhà, địa điểm yêu thích và ranh giới chính trị.

Đang tải các thẻ thông tin về lộ trình

Bạn có thể bắt đầu gửi yêu cầu về ô bản đồ đường sau khi nhận được mã thông báo phiên. Vì mã thông báo phiên áp dụng cho toàn bộ phiên, nên bạn không cần chỉ định các tuỳ chọn bản đồ trong yêu cầu về thẻ thông tin.

Mã mẫu sau đây minh hoạ một yêu cầu mã thông báo phiên thông thường cho các ô bản đồ đường.

curl -X POST -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

Bạn có thể lấy thẻ thông tin bản đồ đường bằng cách gửi yêu cầu HTTPS GET, như trong ví dụ sau.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&orientation=0_or_90_or_180_or_270"

Trong yêu cầu GET HTTPS này, z là mức thu phóng (từ 0 đến 22), còn x và y là tọa độ ô vuông của ô mà bạn muốn truy xuất.

Tham số orientation là không bắt buộc. Giá trị của thuộc tính này chỉ định số độ xoay ngược chiều kim đồng hồ của hình ảnh ô. orientation được hỗ trợ cho các ô roadmap, đồng thời cũng được hỗ trợ cho các yêu cầu về vệ tinh và địa hình khi hình ảnh cơ sở bị xoá bằng "overlay": true và khi layerTypes được đặt. Các giá trị orientation hợp lệ là 0 (mặc định), 90, 180 và 270.

Lưới tọa độ ô vuông sẽ không xoay nếu bạn thêm giá trị orientation. Ví dụ: nếu bạn đặt orientation thành 90, thì toạ độ x vẫn xác định vị trí từ trái sang phải của ô, trong trường hợp này là từ Bắc đến Nam trên bản đồ.

Hướng 0 độ Hướng 90 độ
Hướng 0 độ Hướng 90 độ

Ví dụ về yêu cầu ô

Hãy xem ví dụ sau đây, trong đó yêu cầu một ô chứa toàn bộ thế giới. Trong ví dụ này, mức thu phóng là 0 và toạ độ x và y là 0, 0.

curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

Trong ví dụ này, không có thông báo phản hồi nào từ máy chủ. Thay vào đó, ô này sẽ tải xuống một tệp cục bộ, có các số liệu thống kê sau.

Toàn bộ thế giới trong một ô

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

Để biết thông tin về tiêu đề thư phản hồi, hãy xem phần Tìm nạp trước, lưu vào bộ nhớ đệm hoặc lưu trữ nội dung.