[기술정보] Google Maps Platform Street View API

해당 포스트는 Google Maps Platform의 스트리트 뷰 API에 대한 정보를 담고 있습니다.

Street View API란?

구글맵의 Street View API는 자바 스크립트를 사용하지 않고도 웹 페이지 내에 스트리트 뷰 정적 이미지를 삽입할 수 있는 API입니다. 따라서, Street View API는 URL 파라미터와 함께 HTTP request를 서버에 전송하는 방식을 사용합니다. 파라미터를 설정한 URL을 HTML <img> 태그 등에 삽입하여 원하는 스트리트 뷰 이미지를 가져올 수 있습니다.

 

URL 양식

예시

 

필수 파라미터

 

location 또는 pano

  • location 파라미터는 위/경도값 또는 텍스트로 이루어진 주소값이 필요합니다.
  • ex) location=40.457375,-80.009353 / location=Chagrin Falls, OH
  • pano 파라미터는 특정 파노라마 ID가 필요합니다.
  • ex) pano=cBMoF9_AqIlK81fFNelY3g

 

size

  • size 파라미터는 넓이(width)x높이(height) 형식의 값이 필요합니다.
  • ex) size=600×400

 

key

  • key 파라미터는 API key 값이 필요합니다.
  • ex) key=YOUR_API_KEY
  • 단, 프리미엄 플랜 고객의 경우 client ID와 URL Signing을 이용하여 key 파라미터를 대체할 수 있습니다.
  • URL Signing에 관한 정보는 아래 signature 파라미터 항목에 있는 링크를 참고하십시오.
  • ex) client=YOUR_CLIENT_ID&signature=YOUR_SIGNATURE

 

옵션 파라미터

 

signature

  • 구글에서 사용하기를 권장하는 파라미터로 API key와 URL 서명 비밀번호(URL Signing secret)을 결합하여 만든 암호키가 필요합니다.
  • 프리미엄 플랜 고객의 경우 signature 파라미터가 필수적으로 요구됩니다.
  • URL Signing에 관한 정보는 아래 링크에서 확인하실 수 있습니다.
  • https://developers.google.com/maps/documentation/streetview/get-api-key#premium-auth

 

heading

  • 동서남북의 방향을 지정하는 파라미터로 0부터 360까지의 값을 넣을 수 있습니다.
  • 북쪽은 0과 360, 남쪽은 180, 동쪽은 90의 값을 갖습니다.
  • ex) heading=151.78

 

fov

  • 관측 시야(Field Of View)를 지정하는 파라미터로, 줌(zoom)의 정도를 지정하는 파라미터라 할 수 있습니다.
  • 기본값은 90이며, 최대 120까지 값을 지정할 수 있습니다.
  • ex) fov=30

 

pitch

  • 이미지를 촬영한 카메라의 상하 방향을 설정하는 파라미터입니다.
  • -90에서 90까지의 값을 갖으며, 기본값은 0입니다.

 

radius

  • location 파라미터에서 지정된 위/경도 값을 중심으로 파노라마 반경을 미터 단위로 설정하는 파라미터입니다.
  • 기본값은 50입니다.

 

source

  • 요청한 이미지 결과값에 제약사항을 지정하는 파라미터입니다.
  • 기본값은 default이며 옵션으로는 야외 이미지만 검색하게 하는 outdoor가 있습니다.

 

이미지가 없는 경우

요청한 위치에서 스트리트 뷰 이미지를 가져올 수 없는 경우 아래와 같은 이미지가 출력됩니다.

Generic image displayed when no imagery is available for the specified location

 

 

SPH는 CARTO, Google Maps, SuperMap 등 다양한 케이스에 적용될 수 있는 다채로운 제품군을 보유하고 있으며 고객의 사례에 꼭 맞는 무료 세미나 및 개별 컨설팅을 제공하고 있습니다. 각 케이스에 맞춰 더욱 자세한 이야기를 나누고 싶으시다면 여기에서 문의 주시길 바라며, SPH에서 발행하는 GIS/로케이션 인텔리전스 관련 최신 소식을 받아보고 싶으신 분들은 페이스북 페이지 또는 뉴스레터를 구독해 주시길 바랍니다. 감사합니다.