스트리트 뷰 타일은 다음과 유사합니다.
2D 타일
거리 수준에서 촬영한
파노라마 이미지를 포함하고 있습니다. 다음으로 바꿉니다.
스트리트 뷰로 전 세계의 명소를 탐험하고, 경이로운 자연을 감상하고, 걸을 수 있습니다.
매장, 경기장, 식당, 소규모 업체 내부 등 특정 장소에 의해 결정됩니다.
이 API 엔드포인트를 사용하면 다음에 액세스할 수 있습니다.
- Google 지도 스트리트 뷰 타일
- 스트리트 뷰 메타데이터
- 스트리트 뷰 썸네일
거리 수준에서 찍은 이미지 타일을 함께 연결하여 생생한 파노라마 효과를 제공합니다. 한 세트에 파노라마 ID를 최대 100개까지 쿼리할 수 있습니다. 위치 (예: 경로)를 확인하고 카메라에 관한 더 자세한 메타데이터 가져오기 있습니다.
스트리트 뷰 타일을 병합하려면 뷰어가 필요합니다. 예를 들어 스트리트 뷰 맞춤 파노라마 뷰어를 만들 수 있습니다.
API 키가 있으면 다음 단계를 따르세요.
세션 토큰을 가져옵니다. 반드시
mapType
의 값을streetview
로 설정합니다.세션 토큰을 사용하여 하나 이상의 지리적 파노라마 식별자 (panoId)를 가져옵니다. 위치
panoId 검색 응답의 파노라마 식별자를 사용하여 다음을 가져옵니다.
스트리트 뷰 메타데이터가 포함됩니다. 스트리트 뷰도 좌표와 반경 집합을 전달하여 메타데이터를 확인합니다.
스트리트 뷰 메서드
다음 중 하나를 호출하여 스트리트 뷰 이미지 및 메타데이터에 액세스할 수 있습니다. 네 가지 방법이 있습니다.
메서드 | 설명 |
---|---|
https://tile.googleapis.com/v1/streetview/tiles |
개별 스트리트 뷰 타일을 반환합니다. 스트리트 뷰 타일은 512픽셀(최대 13,312픽셀)의 6가지 확대/축소 수준에서 가져올 수 있습니다. |
https://tile.googleapis.com/v1/streetview/panoIds |
최대 100개의 위치를 일괄 검색할 수 있습니다. 이미지가 있는 모든 위치의 파노라마 ID를 반환합니다. |
https://tile.googleapis.com/v1/streetview/thumbnail |
스트리트 뷰 장면의 썸네일 JPEG 이미지를 반환합니다. 방향, 피치, 크기, 시야를 입력할 수 있습니다. 최소 크기는 16x16픽셀입니다. 최대 크기는 250x600픽셀입니다. |
https://tile.googleapis.com/v1/streetview/metadata |
지정된 파노라마에 대한 자세한 정보를 제공합니다. 세부정보에는 관련 주소와 인접한 파노라마로 연결되는 링크가 포함됩니다. |
스트리트 뷰 panoId 검색
하나 이상의 지리적 위치에 대한 파노라마 식별자는
좌표 (lat
, lng
)를 panoIds
메서드에 전달합니다. 요청
본문은 locations
배열과 선택적으로
radius
: 다음 JSON 코드 예와 같습니다.
curl -X POST -d '{ "locations": [ {"lat": -33.883837, "lng": 151.209307}, {"lat": -33.883700, "lng": 151.210307}, {"lat": 0, "lng": 0} ], "radius": 50 }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/streetview/panoIds?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY"
locations
locations
배열은 하나 이상의 좌표 값 집합을 포함해야 하지만 더 많이 포함할 수 있습니다(최대 100개).radius
radius
값 (미터 단위로 측정됨)은 원의 반지름을 정의합니다. 지정된 위치 주위로 이동하여 파노라마를 검색합니다. 기본값 50미터입니다.
PanoID 응답
Map Tiles API는 각 위치에서 가장 가까운 파노라마를 찾으려고 시도합니다.
파노라마 ID를 반환합니다. panoIds
요청이 성공하면 다음과 같은 결과가 반환됩니다.
panoIds
배열이 포함된 JSON 객체입니다. 배열에는
요청한 순서대로 표시됩니다. Map Tiles API
요청한 위치의 파노라마를 찾을 수 없는 경우
문자열은 배열의 해당 위치에 반환됩니다. 예를 보려면 다음을 참조하세요.
코드를 실행합니다.
{
"panoIds": [
"ACfH-n2HcBvRry_3oc9grw",
"f5DJZatBAAAXHlooS2wKbw",
""
]
}
panoIds
를 사용하여 다음을 할 수 있습니다.
스트리트 뷰 메타데이터
스트리트 뷰 메타데이터 요청은 파노라마에 대한 정보를 검색합니다. 거리 메타데이터 보기 요청은 HTTPS GET 요청입니다. 사용자는 Cloud Shell에서 다음 두 가지 중 한 가지 방법으로 파노라마에 대한 정보를 얻을 수 있습니다.
pano_id
를 전달하면 Map Tiles API에서 이에 대한 메타데이터를 반환합니다. 있습니다.그러나
lat
와lng
를 전달하면 Map Tiles API가 메타데이터를 반환합니다. 지정된 검색 반경 내에서 가장 가까운 파노라마의 경우
좌표와 반경 집합 전달
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY &lat=lat &lng=lng &radius=meters"
파노라마 ID는 일시적이므로
좌표와 radius
값을 반환합니다.
예를 보려면 다음 코드 스니펫을 참조하세요.
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &lat=47.62066 &lng=-122.34923 &radius=50"
스트리트 뷰 이미지의 panoId 전달
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
메타데이터 응답
다음 JSON 코드는 일반적인 메타데이터 응답의 예입니다.
{
"panoId": "rZ9KeTyhA11i0VppYNzsSg",
"lat": 37.420864219339165,
"lng": -122.08446528377291,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"heading": 94.35,
"tilt": 88.39652,
"roll": 1.7181772,
"imageryType": "outdoor",
"date": "2023-01",
"copyright": "© 2023 Google",
"reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
"addressComponents": [
{
"longName": "United States",
"shortName": "United States",
"types": [
"country"
]
},
{
"longName": "Mountain View, California",
"shortName": "Mountain View, California",
"types": [
"locality"
]
},
{
"longName": "Charleston Rd",
"shortName": "Charleston Rd",
"types": [
"route"
]
},
{
"longName": "1635",
"shortName": "1635",
"types": [
"street_number"
]
}
],
"links": [
{
"panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
"heading": 274.47998046875,
"text": "Charleston Rd"
},
{
"panoId": "1cODYwFRw1aZ45IignDIMw",
"heading": 94.47999572753906,
"text": "Charleston Rd"
}
]
}
다음 목록에는 응답 본문의 필드 정의가 포함되어 있습니다.
panoId
- 이 파노라마의 고유 ID입니다. 파노라마 ID에 의존해서는 안 됩니다. 단일 사용자 세션 이상 동안 유효합니다.
lat
,lng
- 파노라마의 좌표 (위도 및 경도)입니다. 이러한 값은 이는 요청에서 전달한 좌표와 다릅니다. 왜냐하면 위치는 가장 가까운 파노라마에 맞습니다.
imageHeight
,imageWidth
- 스티치된 파노라마 이미지의 크기입니다.
tileHeight
,tileWidth
- 단일 파노라마 타일의 크기입니다.
heading
- 북쪽에서 시계 방향으로 측정된 나침반 방위입니다(단위: 도). 제목: [0,360] 범위 내에서 반환되며 0은 정북을 나타냅니다.
tilt
- 파노라마의 기울기로, 남극에서부터 도 단위로 측정됩니다. 지평선에 맞추어 촬영합니다. 반환되는 값은 [0, 180] 범위 내에 있습니다. 값 지평선이 이미 적도와 맞추고 있음을 나타냅니다. 촬영할 수 있습니다.
roll
- 지평선의 수평을 맞추세요. 반환되는 값은 [0, 360] 범위 내에 있습니다.
imageryType
- 이미지 유형을 나타냅니다. 유효한 값은
indoor
,outdoor
입니다. date
- 이미지를 촬영한 날짜입니다. 모든 이미지에 날짜 데이터가 있는 것은 아닙니다. 하지만 사용할 수 있는 경우 이 입력란에는 연도 (YYYY)와 월의 조합이 포함됩니다. (월)). 예: 2023년 5월 또는 2024년
copyright
- 거리와 함께 저작자 표시로 표시해야 하는 저작권 텍스트입니다. 이미지 보기
reportProblemLink
- 사용자가 이 스트리트 뷰의 문제를 신고하는 데 사용할 수 있는 하이퍼링크 타일이 될 수도 있습니다. 이 하이퍼링크는 '문제 신고'와 같은 링크 텍스트가 '이 이미지로 표시'를 클릭하겠습니다.
addressComponent
- 구조화된 지오코드 - 파노라마의 주소에 대한 세부정보를 포함합니다. 자세한 내용은 보기 지오코딩 요청 및 응답 Geocoding API 문서에서 확인할 수 있습니다.
links
- 이 파노라마 ID에 연결되는 파노라마 ID 목록입니다. 다음 제목도 포함: 링크를 찾을 수 있습니다. 예를 들어 방위가 180°이면 연결된 파노라마는 현재 파노라마의 정남입니다. 참고: 하지만 파노라마 ID는 너무 짧기 때문에 더 높은 수익을 올릴 수 있습니다.
스트리트 뷰 썸네일
스트리트 뷰 이미지는 thumbnail
형식으로 요청할 수 있습니다. 썸네일 이미지:
사용자가 정의한 크기, 방향, 피치, 시야를 가진 타일이 아닌 이미지
썸네일 이미지는 타일보다 해상도가 낮고 파일 크기가 작습니다.
있습니다. thumbnail
에 GET 요청을 전송하여 썸네일을 요청합니다.
엔드포인트에 대한 배포를
수행할 수 있습니다
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId &height=FROM_16_TO_250 &width=FROM_16_TO_600 &pitch=FROM-90_TO_90 &yaw=FROM-360_TO_360 &fov=FROM_30_TO_120"
스트리트 뷰의 썸네일을 다운로드하는 다음 코드 예를 생각해 보세요. 캐나다 휘슬러에서 촬영한 이미지
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=Zzl28rqGJgaL2IdkUleP8A &height=200 &width=200 &pitch=0 &yaw=250 &fov=80" --output /tmp/example_thumbnail.png
필수 매개변수
panoId
- 원하는 썸네일의 고유 ID입니다. 파노라마 ID 값은
panoIds
엔드포인트 또는metadata
엔드포인트: 둘 다 지리적 위치를 허용합니다. 좌표를 만들고, 적절한panoId
를 반환합니다. session
- 유효한 세션 토큰
key
- API 키.
선택적 매개변수
height
- 썸네일의 높이를 16~16픽셀로 지정합니다. 250픽셀 높이를 지정하지 않으면 높이가 기본적으로 최대 허용값은 250픽셀입니다. 범위를 벗어난 값을 지정하면 썸네일이 가장 가까운 유효한 값에 맞춰집니다.
width
- 썸네일의 너비를 16~600픽셀로 지정합니다. 픽셀 너비를 지정하지 않으면 기본적으로 최대 너비가 설정됩니다. 허용되는 값인 600픽셀입니다. 범위를 벗어난 값을 지정하면 썸네일이 가장 가까운 유효한 값에 맞춰집니다.
pitch
- 세로축을 따르는 카메라의 각도를 지정합니다. 유효한 값은
범위
-90
~90
(포함) 기본값은 0입니다. yaw
- 가로축을 따라 카메라의 방향을 지정합니다. 유효한 값
범위는
-360
~360
입니다 (포함). 기본값은 s 0입니다. fov
- 가로 시야각을 최대 도 단위로 지정합니다. 120으로 설정합니다. 스트리트 뷰와 마찬가지로 고정 크기 표시 영역을 처리하는 경우 설정된 크기의 이미지로, 시야가 확대/축소를 나타냅니다. 더 작은 값은 더 높은 수준으로 확대할 수 있습니다. 기본값은 90입니다.
스트리트 뷰 이미지 타일
panoId
가 있으면 스트리트 뷰 이미지 타일을 요청할 수 있습니다. 타일
요청은 HTTPS GET 요청입니다 다음 예를 참고하세요.
curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
이 코드 예에서 z
는 확대/축소 수준입니다.
x
및 y
은
타일 좌표
원하는 스트리트 뷰 타일로 이동합니다. 스트리트 뷰 파노라마의 확대/축소 수준은
[0,5] 범위 내에 있어야 하며 0은 가장 넓은 시야를 나타냅니다.
확대/축소 수준 | 대략적인 시야 |
---|---|
0 | 360° |
1 | 180° |
2 | 90° |
3 | 7° |
4 | 22.5° |
5 | 11.25° |
스트리트 뷰 타일 응답
성공적인 스트리트 뷰 타일 요청은 형식과 크기의 이미지를 반환합니다.
createSession
응답에서 지정한 값과 일치해야 합니다.
확대/축소 수준이 0일 때 전체 파노라마는 크기의 타일로 크기가 조정됩니다.
tileHeight
의 tileWidth
입니다. 파노라마는 x차원이 더 크므로
타일은 y 차원에 빈 공간을 포함합니다.
확대/축소 수준 5에서는 원본 크기 파노라마가 사용되고 타일로 분할됩니다.
저작권 정보
모든 스트리트 뷰 파노라마에 저작권 정보를 표시해야 합니다. 이
표시할 문자열은 파노라마마다 다를 수 있습니다. 저작권 정보를 얻으려면
스트리트 뷰 메타데이터를 요청해야 합니다. 그 후에 다음 작업을 할 수 있습니다.
응답의 copyright
필드를 참조합니다. 자세한 내용은
데이터 저작자 표시.