Ô vệ tinh
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)
Các ô hình ảnh vệ tinh là một dạng ảnh trực giao. Đây là những hình ảnh được chụp bằng cả camera vệ tinh và camera trên máy bay, đồng thời cung cấp hình ảnh từ trên xuống (điểm thấp nhất hoặc gần điểm thấp nhất) của trái đất.
Nhận ô vệ tinh
Bạn có thể bắt đầu đưa ra yêu cầu về ô vệ tinh 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 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 ô vệ tinh.
curl -X POST -d '{
"mapType": "satellite",
"language": "en-US",
"region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY
Bạn nhận được các ô vệ tinh 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ụ về mã sau đây, yêu cầu một ô vệ tinh duy nhất ở mức thu phóng 15, với toạ độ x và y là (6294, 13288).
curl "https://tile.googleapis.com/v1/2dtiles/15/6294/13288?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\u003eSatellite image tiles are a type of orthophotography providing top-down imagery of the earth, captured by satellite and airborne cameras.\u003c/p\u003e\n"],["\u003cp\u003eTo request satellite tiles, you need to obtain a session token using your API key, specifying map type, language, and region.\u003c/p\u003e\n"],["\u003cp\u003eYou can then download individual tiles by making HTTPS GET requests, including the zoom level (z), x and y coordinates, session token, and API key in the URL.\u003c/p\u003e\n"],["\u003cp\u003eAn example request shows downloading a tile at zoom level 15 with specific coordinates to a local file, with no server response message besides the downloaded tile.\u003c/p\u003e\n"]]],["Satellite image tiles are top-down images from satellite or airborne cameras. To obtain them, first, request a session token via a POST request, including map type, language, and region. Then, make an HTTPS GET request to retrieve a specific tile by providing zoom level, x and y coordinates, session token, and API key. The requested tile is downloaded directly to a local file without a server response message. An example demonstrates getting a tile at zoom 15 with coordinates (6294, 13288).\n"],null,["# Satellite 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\nSatellite image tiles are a form of orthophotography. They're\nimages captured by both satellite and airborne cameras, and they deliver\ntop-down (nadir or near-nadir) imagery of the earth.\n\nGetting satellite tiles\n-----------------------\n\nYou can begin making satellite tile requests after you get a session token.\nBecause the session token applies to the entire session, you don't have to\nspecify the map options with your tile requests.\n\nThe following code sample demonstrates a typical session token request for\nsatellite tiles. \n\n```json\ncurl -X POST -d '{\n \"mapType\": \"satellite\",\n \"language\": \"en-US\",\n \"region\": \"US\"\n}' \\\n-H 'Content-Type: application/json' \\\n\"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY\n```\n\nYou get satellite tiles by making an HTTPS GET request, as shown in the\nfollowing example. \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 code example, that requests a single satellite tile at\nzoom level 15, with x and y coordinates of (6294, 13288). \n\n```json\ncurl \"https://tile.googleapis.com/v1/2dtiles/15/6294/13288?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)."]]
