Map View

LocalContextMapView 클래스

google.maps.localContext.LocalContextMapView 클래스

지원 중단됨: 로컬 컨텍스트는 지원 중단되었으며 더 이상 새로운 웹사이트에 권장되지 않습니다. 이 기능은 계속 작동하며 지원이 중단되기 12개월 전에 알림이 제공될 예정입니다. 로컬 컨텍스트와 유사한 환경을 직접 빌드하려면 빠른 빌더의 '주변 지역 검색' 솔루션을 확인하거나 Maps JavaScript API의 장소 라이브러리를 사용해보세요. 장소 라이브러리용 코드 샘플 및 Codelab이 도움이 될 수 있습니다.

알림: v=beta 채널에서만 사용할 수 있습니다.

Map를 사용하여 로컬 컨텍스트 환경을 표시합니다.

이 클래스는 LocalContextMapViewOptions를 구현합니다.

const {LocalContextMapView} = await google.maps.importLibrary("localContext")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

생성자
LocalContextMapView	LocalContextMapView(options) 매개변수:  options:  LocalContextMapViewOptions

속성
directionsOptions	유형:  MapDirectionsOptions|MapDirectionsOptionsLiteral optional LocalContextMapViewOptions.directionsOptions 페이지를 참고하세요.
element optional	유형:  HTMLElement|SVGElement optional 이 필드는 읽기 전용입니다. 뷰를 지원하는 DOM 요소.
isTransitioningMapBounds	유형:  boolean LocalContextMapView가 내부 Map의 경계를 변경하기 전에 true로 설정하고, LocalContextMapView가 내부 Map의 경계 변경을 완료하면 false로 설정합니다. (반응형 크기 조절로 인해 레이아웃 모드가 변경되는 경우에는 설정되지 않습니다.)
locationBias	유형:  LocationBias optional LocalContextMapViewOptions.locationBias 페이지를 참고하세요. LocalContextMapView에서 이 속성을 변경하면 새로운 검색이 실행될 수 있습니다.
locationRestriction	유형:  LocationRestriction optional LocalContextMapViewOptions.locationRestriction 페이지를 참고하세요. LocalContextMapView에서 이 속성을 변경하면 새로운 검색이 실행될 수 있습니다.
maxPlaceCount	유형:  number LocalContextMapViewOptions.maxPlaceCount 페이지를 참고하세요. LocalContextMapView에서 이 속성을 변경하면 새로운 검색이 실행될 수 있습니다.
placeTypePreferences	유형:  Array<PlaceTypePreference> LocalContextMapViewOptions.placeTypePreferences 페이지를 참고하세요. LocalContextMapView에서 이 속성을 변경하면 새로운 검색이 실행될 수 있습니다. Iterable<string|PlaceTypePreference>도 허용됩니다.
상속됨: map, pinOptionsSetup, placeChooserViewSetup, placeDetailsViewSetup

방법
addListener	addListener(eventName, handler) 매개변수:  eventName:  string handler:  Function 반환 값:  MapsEventListener 지정된 리스너 함수를 지정된 이벤트 이름에 추가합니다.
hidePlaceDetailsView	hidePlaceDetailsView() 매개변수: 없음 반환 값: 없음 장소 세부정보를 숨깁니다.
search	search() 매개변수: 없음 반환 값: 없음 현재 maxPlaceCount, placeTypePreferences, locationRestriction, locationBias를 기반으로 사용자에게 표시할 장소를 검색합니다.

이벤트
error	function(event) 인수:  event:  ErrorEvent 이 이벤트는 검색을 수행하는 동안 오류가 발생하면 시작됩니다.
placedetailsviewhidestart	function() 인수: 없음 이 이벤트는 장소 세부정보가 애니메이션되기 전에 시작됩니다.
placedetailsviewshowstart	function() 인수: 없음 이 이벤트는 장소 세부정보가 애니메이션되기 전에 시작됩니다.

LocalContextMapViewOptions 인터페이스

google.maps.localContext.LocalContextMapViewOptions 인터페이스

알림: v=beta 채널에서만 사용할 수 있습니다.

LocalContextMapView를 구성하거나 기존 LocalContextMapView에 액세스하는 옵션입니다.

속성
maxPlaceCount	유형:  number 표시할 최대 장소 수입니다. 이 매개변수가 0이면 로컬 컨텍스트 라이브러리는 장소를 로드하지 않습니다. [0,24]
placeTypePreferences	유형:  Array<PlaceTypePreference> 검색할 장소 유형 (최대 10개)입니다. Iterable<string|PlaceTypePreference> 유형도 허용되지만 기본적으로 JavaScript 기호를 지원하는 브라우저에서만 지원됩니다.
directionsOptions optional	유형:  MapDirectionsOptions|MapDirectionsOptionsLiteral optional 경로 맞춤설정을 위한 옵션입니다. 설정하지 않으면 길찾기 및 거리가 사용 중지됩니다.
element optional	유형:  HTMLElement|SVGElement optional 이 필드는 읽기 전용입니다. 뷰를 지원하는 DOM 요소.
locationBias optional	유형:  LocationBias optional 기본값: null 장소를 검색할 때 사용할 소프트 경계 또는 힌트입니다.
locationRestriction optional	유형:  LocationRestriction optional 검색결과를 제한하는 경계입니다. 지정하지 않으면 결과가 지도 표시 영역으로 제한됩니다.
map optional	유형:  Map optional 이미 인스턴스화된 Map 인스턴스입니다. 전달되는 경우 지도는 LocalContextMapView의 DOM으로 이동하며 스타일은 다시 지정되지 않습니다. 지도와 연결된 요소에는 LocalContextMapView에 의해 적용된 스타일과 클래스도 있을 수 있습니다.
pinOptionsSetup optional	유형:  (function({   isSelected:boolean,   isHighlighted:boolean }): (PinOptions optional))|PinOptions optional 아이콘 상태에 따라 장소 마커 아이콘을 구성합니다. 콜백 입력이 변경될 때마다 호출됩니다. LocalContextMapView가 장소 마커를 그릴 때 기본 설정을 동적으로 재정의하는 함수를 전달합니다. 오류 및 잘못된 구성은 비동기식으로 확인될 수 있으며 무시됩니다. 기본값이 사용되며 오류가 콘솔에 기록됩니다.
placeChooserViewSetup optional	유형:  (function({   defaultLayoutMode:PlaceChooserLayoutMode,   defaultPosition:PlaceChooserPosition optional }): (PlaceChooserViewSetupOptions optional))|PlaceChooserViewSetupOptions optional 장소 선택기 뷰의 설정을 재정의합니다. LocalContextMapView가 크기 조절로 인해 레이아웃을 변경할 수 있는 경우 기본 설정을 동적으로 재정의하는 함수를 전달합니다. 오류와 잘못된 구성은 비동기식으로 확인될 수 있으며 무시됩니다. 대신 기본값이 사용되며 오류가 콘솔에 기록됩니다. 생성 시 오류가 감지되면 오류가 동기식으로 발생합니다.
placeDetailsViewSetup optional	유형:  (function({   defaultLayoutMode:PlaceDetailsLayoutMode,   defaultPosition:PlaceDetailsPosition optional }): (PlaceDetailsViewSetupOptions optional))|PlaceDetailsViewSetupOptions optional 장소 세부정보 보기의 설정을 재정의합니다. LocalContextMapView가 크기 조절로 인해 레이아웃을 변경할 수 있는 경우 기본 설정을 동적으로 재정의하는 함수를 전달합니다. 오류 및 잘못된 구성은 비동기식으로 확인될 수 있으며 무시됩니다. 기본값이 사용되며 오류가 콘솔에 기록됩니다. 생성 시 오류가 감지되면 오류가 동기식으로 발생합니다.

PlaceTypePreference typedef

google.maps.localContext.PlaceTypePreference typedef

알림: v=beta 채널에서만 사용할 수 있습니다.

검색할 장소 유형 및 사용할 무게. weight를 생략하면 라이브러리가 기본 가중치를 결정하며, 이는 시간이 지남에 따라 변경되고 개선될 수 있습니다.

{
  type:string,
  weight:number optional
}

MapDirectionsOptions 클래스

google.maps.localContext.MapDirectionsOptions 클래스

알림: v=beta 채널에서만 사용할 수 있습니다.

LocalContextMapView를 사용하여 경로 설정을 제공합니다.

이 클래스는 MapDirectionsOptionsLiteral를 구현합니다.

const {MapDirectionsOptions} = await google.maps.importLibrary("localContext")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

속성
상속됨: origin

방법
addListener	addListener(eventName, handler) 매개변수:  eventName:  string handler:  Function 반환 값:  MapsEventListener 지정된 리스너 함수를 지정된 이벤트 이름에 추가합니다.

MapDirectionsOptionsLiteral 인터페이스

google.maps.localContext.MapDirectionsOptionsLiteral 인터페이스

알림: v=beta 채널에서만 사용할 수 있습니다.

편의상 여러 위치에서 MapDirectionsOptions 객체 대신 객체 리터럴이 허용됩니다. 이 객체는 지도 API가 만나면 MapDirectionsOptions 객체로 변환됩니다.

속성
origin	유형:  LatLng|LatLngLiteral 경로 및 거리의 출발지입니다.

PinOptions 인터페이스

google.maps.localContext.PinOptions 인터페이스

알림: v=beta 채널에서만 사용할 수 있습니다.

핀 마커를 맞춤설정하기 위한 옵션입니다.

속성
background optional	유형:  string optional 아이콘 모양 색상은 유효한 CSS 색상이라면 무엇이든 가능합니다.
glyphColor optional	유형:  string optional 아이콘 글리프의 색상은 유효한 CSS 색상이라면 무엇이든 가능합니다.
scale optional	유형:  number optional 아이콘의 크기입니다. 이 값은 절댓값이며 각 상태의 기본 크기와 관련이 없습니다.

PlaceChooserViewSetupOptions 인터페이스

google.maps.localContext.PlaceChooserViewSetupOptions 인터페이스

장소 선택기의 설정 옵션입니다. 레이아웃 및 공개 상태 설정에 관해 자세히 알아보세요.

속성
layoutMode optional	유형:  PlaceChooserLayoutMode optional
position optional	유형:  PlaceChooserPosition optional layoutMode:HIDDEN인 경우 무시됩니다. 통과하지 못하면 layoutMode를 기준으로 게재순위가 자동으로 결정됩니다.

PlaceChooserLayoutMode 상수

google.maps.localContext.PlaceChooserLayoutMode 상수

알림: v=beta 채널에서만 사용할 수 있습니다.

장소 선택기의 레이아웃 모드

const {PlaceChooserLayoutMode} = await google.maps.importLibrary("localContext")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

상수
HIDDEN	장소 선택기가 숨겨져 있습니다.
SHEET	장소 선택기가 시트로 표시됩니다.

PlaceChooserPosition 상수

google.maps.localContext.PlaceChooserPosition 상수

알림: v=beta 채널에서만 사용할 수 있습니다.

장소 선택기의 위치를 표시합니다.

const {PlaceChooserPosition} = await google.maps.importLibrary("localContext")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

상수
BLOCK_END	장소 선택기는 지도 아래의 컨테이너의 끝으로 확장되는 선에 표시됩니다.
INLINE_END	장소 선택기는 선 끝에 지도와 함께 인라인으로 표시됩니다. 왼쪽에서 오른쪽으로 읽는 언어에서는 장소 선택기가 지도의 오른쪽에 있습니다.
INLINE_START	장소 선택기는 선의 시작 부분에서 지도와 함께 인라인으로 표시됩니다. 왼쪽에서 오른쪽으로 읽는 언어에서는 장소 선택기가 지도의 왼쪽에 있습니다.

PlaceDetailsViewSetupOptions 인터페이스

google.maps.localContext.PlaceDetailsViewSetupOptions 인터페이스

장소 세부정보의 설정 옵션입니다. 레이아웃 및 공개 상태 설정에 관해 자세히 알아보세요.

속성
hidesOnMapClick optional	유형:  boolean optional
layoutMode optional	유형:  PlaceDetailsLayoutMode optional
position optional	유형:  PlaceDetailsPosition optional layoutMode:INFO_WINDOW인 경우 무시됩니다. 통과하지 못하면 layoutMode를 기준으로 게재순위가 자동으로 결정됩니다.

PlaceDetailsLayoutMode 상수

google.maps.localContext.PlaceDetailsLayoutMode 상수

알림: v=beta 채널에서만 사용할 수 있습니다.

장소 세부정보의 레이아웃 모드

const {PlaceDetailsLayoutMode} = await google.maps.importLibrary("localContext")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

상수
INFO_WINDOW	장소 세부정보는 InfoWindow에 표시됩니다.
SHEET	장소 세부정보가 시트에 표시됩니다.

PlaceDetailsPosition 상수

google.maps.localContext.PlaceDetailsPosition 상수

알림: v=beta 채널에서만 사용할 수 있습니다.

장소 세부정보의 위치를 표시합니다.

const {PlaceDetailsPosition} = await google.maps.importLibrary("localContext")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

상수
INLINE_END	장소 세부정보는 선 끝에 지도와 함께 일렬로 표시됩니다. 왼쪽에서 오른쪽으로 읽는 언어에서는 장소 세부정보가 지도의 오른쪽에 있습니다.
INLINE_START	장소 세부정보는 선의 시작 부분에서 지도와 나란히 표시됩니다. 왼쪽에서 오른쪽으로 읽는 언어에서는 장소 세부정보가 지도의 왼쪽에 있습니다.