Thẻ thông tin lộ trình 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. Bao gồm đường, toà nhà, điểm tham quan và ranh giới chính trị.
Nhận thẻ thông tin về lộ trình
Bạn có thể bắt đầu tạo các yêu cầu thẻ thông tin lộ trình 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 đồ bằng các yêu cầu 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 thẻ thông tin 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 có thể nhận được thẻ thông tin về lộ trình bằng cách tạo một yêu cầu GET HTTPS, 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 độ ô của ô mà bạn muốn truy xuất.
Bạn không bắt buộc phải sử dụng tham số orientation. 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 xếp kề. orientation được hỗ trợ cho thẻ thông tin roadmap, đồng thời cũng được hỗ trợ cho các yêu cầu về hình ảnh vệ tinh và địa hình đã xoá hình ảnh cơ sở bằng "overlay": true và đã đặt layerTypes. Các giá trị orientation hợp lệ là 0 (mặc định), 90, 180 và 270.
Lưới toạ độ của thẻ thông tin 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 thẻ thông tin, trong trường hợp này là từ Bắc xuống Nam trên bản đồ.
| 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 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
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 sẽ tải xuống một tệp cục bộ, với số liệu thống kê sau.
% 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ông báo 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.