Ô đường đi

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

Đang tải ô lộ trình

Bạn có thể bắt đầu tạo yêu cầu ô lộ trình sau khi nhận được mã thông báo phiên. Vì mã thông báo phiên sẽ áp dụng cho toàn bộ phiên, bạn không cần phải chỉ định bản đồ với các yêu cầu thẻ thông tin của mình.

Mã mẫu sau đây minh hoạ một yêu cầu mã thông báo phiên điển hình cho thẻ lộ trình.

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 sẽ nhận được các ô lộ trình bằng cách đưa ra một yêu cầu HTTPS GET, như minh hoạ sau đây ví dụ:

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 (trong khoảng từ 0 đến 22) và xytọa độ ô thẻ thông tin mà bạn muốn truy xuất.

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

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

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

Ví dụ về yêu cầu thẻ thông tin

Hãy xem xét ví dụ sau đây: yêu cầu một thẻ thông tin duy nhất chứa toàn thế giới. Trong ví dụ này, mức thu phóng là 0, còn các 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

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

Cả thế giới trong một thẻ thông tin

  % 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 đề của thư phản hồi, hãy xem Tìm nạp trước, lưu vào bộ nhớ đệm hoặc lưu trữ nội dung.