Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
위성 타일
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
위성 이미지 타일은 정사영상입니다. 위성 및 공중 카메라로 촬영한 이미지로, 지구의 하향식 (천저 또는 천저에 가까운) 이미지를 제공합니다.
위성 타일 가져오기
세션 토큰을 가져온 후 위성 타일 요청을 시작할 수 있습니다.
세션 토큰은 전체 세션에 적용되므로 타일 요청과 함께 지도 옵션을 지정할 필요가 없습니다.
다음 코드 샘플은 위성 타일에 대한 일반적인 세션 토큰 요청을 보여줍니다.
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
다음 예와 같이 HTTPS GET 요청을 실행하여 위성 타일을 가져옵니다.
curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY"
타일 요청 예
확대/축소 수준 15에서 x 및 y 좌표가 (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
이 예에서는 서버의 응답 메시지가 없습니다. 대신 타일이 로컬 파일로 다운로드됩니다.

응답 메시지 헤더에 대한 자세한 내용은
콘텐츠 프리패치, 캐싱 또는 저장을 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-04-29(UTC)
[null,null,["최종 업데이트: 2026-04-29(UTC)"],[],["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"]]