Gạch địa hình
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)
Ô địa hình là ô hình ảnh chứa thông tin ánh sáng địa hình và đường đồng mức. Chúng bao gồm các đặc điểm tự nhiên như thảm thực vật.
Nhận ô địa hình
Bạn có thể bắt đầu đưa ra yêu cầu về ô địa hì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 phải chỉ định các lựa chọn về bản đồ bằng yêu cầu về ô.
Mẫu mã sau đây minh hoạ một yêu cầu mã thông báo phiên điển hình cho các ô địa hình.
curl -X POST -d '{
"mapType": "terrain",
"language": "en-US",
"region": "US",
"layerTypes": ["layerRoadmap"]
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
Bạn nhận được các ô địa hình bằng cách thực hiện một yêu cầu HTTPS GET, như minh hoạ trong ví dụ sau.
curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY"
Ví dụ về yêu cầu về ô
Hãy xem xét ví dụ sau đây, yêu cầu một ô địa hình duy nhất có mức thu phóng là 10, với toạ độ x và y là (192, 401).
curl "https://tile.googleapis.com/v1/2dtiles/10/192/401?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 chỉ tải xuống một tệp cục bộ.
Để 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.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eTerrain tiles are image tiles that visually represent geographical features like hills, contours, and vegetation.\u003c/p\u003e\n"],["\u003cp\u003eTo request terrain tiles, you first need to obtain a session token using your API key and specifying map parameters.\u003c/p\u003e\n"],["\u003cp\u003eYou can then retrieve individual terrain tiles using an HTTPS GET request, providing the session token, API key, and desired tile coordinates (zoom level, x, and y).\u003c/p\u003e\n"],["\u003cp\u003eTerrain tiles are downloaded directly as image files without a server response message, allowing easy integration into mapping applications.\u003c/p\u003e\n"]]],["Terrain tiles, which include hillshade mapping, contour lines, and natural features, are accessed by first obtaining a session token via a POST request specifying the map type, language, region, and layer types. Subsequently, tiles are retrieved with HTTPS GET requests, providing the zoom level (z), x and y coordinates, and the session token. An example demonstrates requesting a tile at zoom level 10, with coordinates (192, 401). The tile data downloads to a local file, without a server response message.\n"],null,["# Terrain tiles\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google\n| Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. [Learn more](/maps/comms/eea/faq). In addition, certain content from the Map Tiles API will no longer be returned. [Learn more](/maps/comms/eea/map-tiles).\n\nTerrain tiles are image tiles that contain hillshade mapping\nand contour lines. They include natural features such as vegetation.\n\nGetting terrain tiles\n---------------------\n\nYou can begin making terrain tile requests after you get a session token.\nBecause a session token applies to the entire session, you don't have to specify\nthe map options with your tile requests.\n\nThe following code sample demonstrates a typical session token request for\nterrain tiles. \n\n```json\ncurl -X POST -d '{\n \"mapType\": \"terrain\",\n \"language\": \"en-US\",\n \"region\": \"US\",\n \"layerTypes\": [\"layerRoadmap\"]\n}' \\\n-H 'Content-Type: application/json' \\\n\"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY\"\n```\n\nYou get terrain tiles by making an HTTPS GET request, as shown in the following\nexample. \n\n```json\ncurl \"https://tile.googleapis.com/v1/2dtiles/\u003cvar class=\"apiparam\" translate=\"no\"\u003ez\u003c/var\u003e/\u003cvar class=\"apiparam\" translate=\"no\"\u003ex\u003c/var\u003e/\u003cvar class=\"apiparam\" translate=\"no\"\u003ey\u003c/var\u003e?session=\u003cvar class=\"apiparam\" translate=\"no\"\u003eYOUR_SESSION_TOKEN\u003c/var\u003e&key=YOUR_API_KEY\"\n```\n\nExample tile request\n--------------------\n\nConsider the following example, which requests a single terrain tile with zoom\nlevel 10, with x and y coordinates of (192, 401). \n\n```json\ncurl \"https://tile.googleapis.com/v1/2dtiles/10/192/401?session=\u003cvar class=\"apiparam\" translate=\"no\"\u003eYOUR_SESSION_TOKEN\u003c/var\u003e&key=YOUR_API_KEY\" --output /tmp/example_tile.png\n```\n\nThere is no response message from the server in this example. Instead, the tile\njust downloads to a local file.\n\nFor information about response message headers, see\n[Pre-Fetching, Caching, or Storage of Content](/maps/documentation/tile/policies#pre-fetching,-caching,-or-storage-of-content)."]]
