Ô đường đi

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

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

Nhận thẻ lộ trình

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

Mã mẫu sau đây minh hoạ một yêu cầu điển hình về mã phiên cho ô 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 thẻ lộ trình bằng cách đưa ra 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 độ ô vuông của ô vuông mà bạn muốn truy xuất.

Tham số orientation là không bắt buộc. Giá trị của tham số này chỉ định số độ xoay ngược chiều kim đồng hồ của hình ảnh thẻ. orientation được hỗ trợ cho thẻ 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 cách sử dụng "overlay": true, và khi layerTypes được đặt. Các giá trị orientation hợp lệ là 0 (giá trị mặc định), 90, 180 và 270.

Lưới tọa độ ô vuông sẽ không xoay nếu bạn đưa vào 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ẻ, 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 độ

Yêu cầu mẫu về thẻ

Hãy xem ví dụ sau đây, trong đó yêu cầu một thẻ duy nhấ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

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ẻ sẽ tải xuống một tệp cục bộ, với 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ông báo phản hồi, hãy xem bài viết Tìm nạp trước, lưu vào bộ nhớ đệm hoặc lưu trữ nội dung.