모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Street View Image API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Street View Image API 활성화
  3. 적합한 키 생성
계속

Google Street View Image API

소개

Google Street View Image API를 사용하면, JavaScript를 사용하지 않고도 정적(비대화형) 스트리트 뷰 파노라마 또는 썸네일을 웹 페이지에 포함할 수 있습니다. 표준 HTTP 요청을 통해 전송된 URL 매개변수를 사용하여 뷰포트가 정의되며, 뷰포트는 정적 이미지로 반환됩니다.

https://maps.googleapis.com/maps/api/streetview?size=400x400&location=40.720032,-73.988354
&fov=90&heading=235&pitch=10
&key=YOUR_API_KEY

URL 매개변수

스트리트 뷰 이미지 요청은 다음 형식의 HTTP URL입니다.

https://maps.googleapis.com/maps/api/streetview?parameters

이미지는 요청 매개변수를 사용하여 지정됩니다. URL 표준 형식과 마찬가지로, 모든 매개변수는 앰퍼샌드(&) 문자를 사용하여 구분합니다. 허용되는 매개변수 및 가능한 값은 아래와 같습니다.

필수 매개변수

  • location은 텍스트 문자열(예: Chagrin Falls, OH) 또는 위도/경도 값(40.457375,-80.009353)이 될 수 있습니다. Google Street View Image API는 가장 근접 촬영된 파노라마를 이 위치에 스냅합니다. 주소 텍스트 문자열이 제공되면 API는 다른 카메라 위치를 사용하여 지정된 위치를 더 잘 표시할 수 있습니다. 위도/경도가 제공되면 API는 이 위치와 가장 가까운 사진의 반경 50미터를 검색합니다. 스트리트 뷰 이미지는 주기적으로 갱신되므로 사진 촬영 위치가 매번 약간씩 다를 수 있으며, 이미지가 업데이트될 때 다른 파노라마에 location이 스냅될 가능성이 있습니다.

또는:

  • pano는 특정한 파노라마 ID이며, 일반적으로 안정적입니다.

또한:

  • size는 이미지의 출력 크기를 픽셀 단위로 지정합니다. 크기는 {width}x{height}로 지정됩니다. 예를 들어, size=600x400은 너비 600픽셀, 높이 400픽셀의 이미지를 반환합니다.
  • key를 사용하면 Google API Console에서 애플리케이션의 API 사용량을 모니터링하고, 넉넉한 무료 일일 할당량에 액세스하고, 필요한 경우 Google이 애플리케이션에 대해 여러분에게 문의할 수 있습니다. 자세한 내용은 키 및 서명 가져오기를 참조하세요.

    참고: Google Maps API 프리미엄 플랜 고객은 Street View 요청에서 API 키와 디지털 서명을 사용하거나 유효한 클라이언트 ID와 디지털 서명을 사용할 수 있습니다. 자세한 내용은 프리미엄 플랜 고객의 인증 매개변수를 참조하세요.

    이전 Google Maps APIs for Work 라이선스를 보유한 고객은 요청 시 key 대신에 유효한 clientsignature 매개변수를 포함해야 합니다. 자세한 내용은 키 및 서명 가져오기 페이지의 클라이언트 ID 및 서명 섹션을 참조하세요.

선택적 매개변수

  • signature(권장)는 여러분의 API 키를 사용해 요청을 생성하는 사이트가 있을 경우, 해당 사이트가 그러한 권한이 있는지 확인해주는 디지털 서명입니다. 참고: 결제를 활성화하는 경우 디지털 서명이 필요합니다. 지도 로드의 하루 무료 제한을 초과한 경우 당일 남은 시간 동안의 추가 지도 로드는 요금이 부과됩니다. 디지털 서명을 포함하지 않은 결제 가능 지도 로드는 실패합니다. 자세한 내용은 키 및 서명 가져오기를 참조하세요.

    참고: Google Maps API 프리미엄 플랜 고객의 경우 디지털 서명이 필요합니다. 자세한 내용은 프리미엄 플랜 고객의 인증 매개변수를 참조하세요.

  • heading은 카메라의 나침반 방위를 나타냅니다. 허용되는 값은 0 ~ 360입니다. (이 두 값은 북쪽을 나타내고, 90은 동쪽, 180은 남쪽을 나타냅니다.) 방위가 지정되지 않은 경우, 카메라를 지정된 location으로 향하고 가장 근접 사진이 촬영된 지점에서 값이 계산됩니다.
  • fov(기본값 90)는 이미지의 수평 시야각을 판별합니다. 시야각은 도 단위로 표현되며, 최대 허용값은 120입니다. 고정된 크기의 뷰포트를 다룰 경우에는, 설정된 크기의 스트리트 뷰 이미지와 마찬가지로, 시야각은 기본적으로 확대/축소를 나타내며 숫자가 작을수록 확대/축소 수준이 더 높습니다.



    (왼쪽: fov=120; 오른쪽: fov=20)

  • pitch(기본값 0)는 스트리트 뷰 차량을 기준으로 상대적인 상하 카메라 각도를 지정합니다. 이 값은 항상 그렇지는 않지만 대개는 완전 수평입니다. 양수 값은 카메라 각도를 위로 올리고(90도는 상방 수직), 음수 값은 카메라 각도를 아래로 내립니다(-90도는 하방 수직).

아래는 예시 요청입니다.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY

사용 가능한 이미지 없음

스트리트 뷰 이미지를 사용할 수 없는 위치의 경우 Google Street View Image API는 "Sorry, we have no imagery here."라는 텍스트가 표시된 회색의 일반 이미지를 반환합니다.

지정된 위치에 사용 가능한 이미지가 없는 경우에 표시되는 일반 이미지
그림: 지정된 위치에 사용 가능한 이미지가 없는 경우에 표시되는 일반 이미지

이 시나리오를 피하기 위해 스트리트 뷰 이미지 메타데이터를 요청하여 지정된 위치에서 사용할 수 있는 이미지와 그에 대한 다른 데이터가 있는지 확인할 수 있습니다.

추가 정보

Google Street View Image API 사용 방법이나 다른 Google Maps API 제품에 대한 자세한 내용은, Maps API 지원 페이지를 참조하세요.

다음에 대한 의견 보내기...

Google Street View Image API
도움이 필요하시나요? 지원 페이지를 방문하세요.