StreetViewService 클래스
google.maps.StreetViewService
클래스
StreetViewService
객체는 스트리트 뷰 데이터를 검색합니다.
const {StreetViewService} = await google.maps.importLibrary("streetView")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
---|---|
StreetViewService |
StreetViewService() 매개변수: 없음
스트리트 뷰 서비스에 저장된 데이터에 인터페이스를 제공하는 StreetViewService 를 만듭니다. |
방법 | |
---|---|
getPanorama |
getPanorama(request[, callback]) 매개변수:
반환 값:
Promise<StreetViewResponse> 제공된 스트리트 뷰 쿼리 요청과 일치하는 파노라마의 StreetViewPanoramaData 를 검색합니다. StreetViewPanoramaData 는 제공된 콜백에 전달됩니다. |
StreetViewStatus 상수
google.maps.StreetViewStatus
상수
스트리트 뷰 요청 완료 시 StreetViewService
에서 반환한 상태입니다. 값 또는 상수 이름을 사용하여 지정할 수 있습니다. 예를 들어 'OK'
또는 google.maps.StreetViewStatus.OK
입니다.
const {StreetViewStatus} = await google.maps.importLibrary("streetView")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
상수 | |
---|---|
OK |
요청이 성공했습니다. |
UNKNOWN_ERROR |
요청을 처리하지 못했으며 실패에 대한 정확한 원인을 알 수 없습니다. |
ZERO_RESULTS |
검색 기준과 일치하는 파노라마가 없습니다. |
StreetViewLocationRequest 인터페이스
google.maps.StreetViewLocationRequest
인터페이스
getPanorama
에서 전송할 스트리트 뷰 요청입니다. StreetViewLocationRequest
를 사용하면 지정된 위치에서 스트리트 뷰 파노라마를 검색할 수 있습니다.
속성 | |
---|---|
location optional |
유형:
LatLng|LatLngLiteral optional 스트리트 뷰 파노라마를 검색할 위치를 지정합니다. |
preference optional |
유형:
StreetViewPreference optional 반경 내에서 파노라마를 찾아야 하는 환경설정(제공된 위치에 가장 가까운 파노라마 또는 반경 내에서 가장 좋은 파노라마)을 설정합니다. |
radius optional |
유형:
number optional 기본값:
50 파노라마를 검색할 반경을 미터 단위로 설정합니다. |
|
유형:
StreetViewSource optional 검색할 파노라마의 소스를 지정합니다. 이렇게 하면 예를 들어 야외 파노라마만 검색할 수 있습니다. |
sources optional |
유형:
Iterable<StreetViewSource> optional 기본값: [
StreetViewSource.DEFAULT ]검색할 파노라마의 출처를 지정합니다. 이렇게 하면 예를 들어 야외 파노라마만 검색할 수 있습니다. 소스를 여러 개 설정하면 이러한 소스의 교집합으로 평가됩니다. |
StreetViewPanoRequest 인터페이스
google.maps.StreetViewPanoRequest
인터페이스
StreetViewPanoRequest
는 getPanorama
와 함께 지정된 ID가 있는 파노라마를 찾는 데 사용됩니다.
속성 | |
---|---|
pano optional |
유형:
string optional 검색할 pano ID를 지정합니다. |
StreetViewResponse 인터페이스
google.maps.StreetViewResponse
인터페이스
StreetViewService.getPanorama
의 프로미스에 대한 응답이 해결되었습니다.
속성 | |
---|---|
data |
파노라마의 표현입니다. |
StreetViewLocation 인터페이스
google.maps.StreetViewLocation
인터페이스
스트리트뷰 파노라마에 있는 위치 표시입니다.
속성 | |
---|---|
pano |
유형:
string 파노라마에 대한 고유 식별자입니다. 이 ID는 한 세션 안에서는 안정적이지만 세션 간에는 변경될 수 있습니다. |
description optional |
유형:
string optional 위치를 설명하는 현지화된 문자열입니다. |
latLng optional |
유형:
LatLng optional 파노라마의 latlng입니다. |
shortDescription optional |
유형:
string optional 위치에 대한 간단한 설명입니다. |
StreetViewPreference 상수
google.maps.StreetViewPreference
상수
요청 위치에 가장 가까운 스트리트 뷰 파노라마 또는 사용자가 보고 싶어할 가능성이 가장 높은 것으로 간주되는 파노라마를 반환하도록 검색 결과를 편중하는 옵션입니다. 값 또는 상수 이름을 사용하여 지정합니다. 예를 들면 'best'
또는 google.maps.StreetViewPreference.BEST
이 있습니다.
const {StreetViewPreference} = await google.maps.importLibrary("streetView")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
상수 | |
---|---|
BEST |
사용자가 보고 싶어할 가능성이 가장 높은 것으로 간주되는 스트리트 뷰 파노라마를 반환합니다. 최적의 결과는 인식된 관심 장소, 이미지 품질, 특정 위치로부터의 거리와 같은 사용자 연구 및 매개변수를 기반으로 하는 알고리즘에 의해 결정됩니다. |
NEAREST |
제공된 위치에서 최단 거리인 스트리트 뷰 파노라마를 반환합니다. 이 기능은 제한된 반경 내에서만 작동합니다. 권장 반경은 1km 이하입니다. |
StreetViewSource 상수
google.maps.StreetViewSource
상수
스트리트 뷰 검색을 선택한 소스로 제한하는 식별자입니다. 이러한 값은 문자열로 지정됩니다. 예를 들면 다음과 같습니다. 'outdoor'
const {StreetViewSource} = await google.maps.importLibrary("streetView")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
상수 | |
---|---|
DEFAULT |
스트리트 뷰의 기본 출처를 사용합니다. 검색은 특정 출처로 제한되지 않습니다. |
GOOGLE |
스트리트 뷰 검색을 공식 Google 컬렉션으로 제한합니다. |
OUTDOOR |
스트리트 뷰 검색을 야외 컬렉션으로 제한합니다. 실내 컬렉션은 검색결과에 포함되지 않습니다. 또한 파노라마가 실내 또는 실외에 있는지 확인할 수 있는 경우에만 검색 결과로 표시됩니다. 예를 들어 PhotoSpheres가 실내에 있는지 야외에 있는지 알 수 없으므로 반환되지 않습니다. |
StreetViewPanoramaData 인터페이스
google.maps.StreetViewPanoramaData
인터페이스
registerPanoProvider
를 사용하여 정의된 제공자에서 반환된 파노라마의 표시입니다.
속성 | |
---|---|
tiles |
이 파노라마에 대한 맞춤형 타일을 지정합니다. |
copyright optional |
유형:
string optional 이 파노라마에 대한 저작권 텍스트를 지정합니다. |
imageDate optional |
유형:
string optional 이 파노라마의 이미지를 가져온 연도와 월을 지정합니다. 날짜 문자열은 YYYY-MM 형식입니다. |
links optional |
유형:
Array<StreetViewLink> optional 인접 파노라마에 대한 탐색 링크를 지정합니다. |
location optional |
유형:
StreetViewLocation optional 이 파노라마에 대한 위치 메타-데이터를 지정합니다. |
StreetViewLink 인터페이스
google.maps.StreetViewLink
인터페이스
인접한 스트리트뷰 pano에 대한 참조 집합입니다.
속성 | |
---|---|
description optional |
유형:
string optional 링크를 설명하는 현지화된 문자열입니다. |
heading optional |
유형:
number optional 링크의 방향(heading)입니다. |
pano optional |
유형:
string optional 파노라마에 대한 고유 식별자입니다. 이 ID는 한 세션 안에서는 안정적이지만 세션 간에는 변경될 수 있습니다. |