공지사항: 새로운 기본 지도 스타일이 곧 Google Maps Platform에 제공될 예정입니다. 이 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트, 현대화된 핀, 지도 환경 및 사용성 개선사항이 포함됩니다. 모든 지도 스타일이 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 더 일찍 선택하는 방법에 대한 자세한 내용은 Google Maps Platform용 새로운 지도 스타일을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Data-driven styling

FeatureLayer 인터페이스

google.maps.FeatureLayer 인터페이스

스타일을 클라이언트 측에서 재정의하거나 이벤트를 연결할 수 있는 특정 FeatureType의 지형지물이 포함된 지도 레이어를 나타내는 인터페이스입니다.

속성
`featureType`	유형: `FeatureType` 이 `FeatureLayer`와 연결된 `FeatureType`입니다.
`isAvailable`	유형: `boolean` 이 `FeatureLayer`를 사용할 수 있는지 여부, 즉 이 지도에 데이터 기반 스타일 지정을 사용할 수 있는지 여부입니다. Google Cloud 콘솔 지도 스타일에서 이 `FeatureLayer`가 사용 설정된 벡터 타일을 사용하는 지도 ID가 있습니다. 이 값이 false이거나 false가 되면 이 `FeatureLayer`의 스타일이 기본값으로 돌아가고 이벤트가 트리거되지 않습니다.
`datasetId optional`	참고: v=beta 채널에서만 사용할 수 있습니다. 유형: `string optional` 이 `FeatureLayer`의 데이터 세트 ID입니다. `featureType`가 `FeatureType.DATASET`인 경우에만 표시됩니다.
`style optional`	유형: `FeatureStyleOptions\|FeatureStyleFunction optional` `FeatureLayer`의 `Feature` 스타일입니다. 스타일은 스타일이 설정될 때 적용됩니다. 스타일 함수가 업데이트되면 스타일 속성을 다시 설정해야 합니다. `FeatureStyleFunction`는 지도 타일에 적용될 때 일관된 결과를 반환해야 하며 성능에 맞게 최적화되어야 합니다. 비동기 함수는 지원되지 않습니다. `FeatureStyleOptions`를 사용하면 해당 레이어의 모든 지형지물에 동일한 `FeatureStyleOptions` 스타일이 적용됩니다. 스타일을 `null`로 설정하여 이전에 설정된 스타일을 삭제합니다. 이 `FeatureLayer`를 사용할 수 없는 경우 스타일 설정은 아무것도 하지 않고 오류를 로깅합니다.

메서드
`addListener`	`addListener(eventName, handler)` 매개변수: `eventName`: `string` 관찰된 이벤트입니다. `handler`: `Function` 이벤트를 처리하는 함수입니다. 반환 값: `MapsEventListener` 결과 이벤트 리스너입니다. 지정된 리스너 함수를 지정된 이벤트 이름에 추가합니다. `event.removeListener`와 함께 사용할 수 있는 이 리스너의 식별자를 반환합니다.

메서드

addListener

addListener(eventName, handler)

매개변수:

eventName: string 관찰된 이벤트입니다.
handler: Function 이벤트를 처리하는 함수입니다.

반환 값: MapsEventListener 결과 이벤트 리스너입니다.

지정된 리스너 함수를 지정된 이벤트 이름에 추가합니다. event.removeListener와 함께 사용할 수 있는 이 리스너의 식별자를 반환합니다.

이벤트
`click`	`function(event)` 인수: `event`: `FeatureMouseEvent` 이 이벤트는 `FeatureLayer`가 클릭될 때 실행됩니다.
`mousemove`	`function(event)` 인수: `event`: `FeatureMouseEvent` 이 이벤트는 사용자의 마우스가 `FeatureLayer` 위로 이동할 때 실행됩니다.

FeatureType 상수

google.maps.FeatureType 상수

지형지물 유형의 식별자입니다.

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

상수
`ADMINISTRATIVE_AREA_LEVEL_1`	국가 수준 아래 첫 번째 행정 독립체를 나타냅니다.
`ADMINISTRATIVE_AREA_LEVEL_2`	국가 수준 아래 두 번째 행정 독립체를 나타냅니다.
`COUNTRY`	국가의 정치적 독립체를 나타냅니다.
`DATASET`	참고: v=beta 채널에서만 사용할 수 있습니다. 서드 파티 데이터 세트를 나타냅니다.
`LOCALITY`	도시 또는 마을로 통합된 정치적 독립체를 나타냅니다.
`POSTAL_CODE`	국가 내에서 우편물을 보낼 때 사용되는 우편번호를 나타냅니다. 우편번호를 포함합니다.
`SCHOOL_DISTRICT`	교육구를 나타냅니다.

FeatureStyleFunction typedef

google.maps.FeatureStyleFunction typedef

FeatureLayer의 스타일을 지정하는 함수입니다.

function(FeatureStyleFunctionOptions): (FeatureStyleOptions optional)

FeatureStyleFunctionOptions 인터페이스

google.maps.FeatureStyleFunctionOptions 인터페이스

FeatureStyleFunction에 전달된 옵션입니다.

속성
`feature`	유형: `Feature` 스타일 지정을 위해 `FeatureStyleFunction`에 전달된 `Feature`

FeatureStyleOptions 인터페이스

google.maps.FeatureStyleOptions 인터페이스

이 옵션은 지도에서 Feature의 스타일을 수정하는 방법을 지정합니다.

속성
`fillColor optional`	유형: `string optional` 16진수 RGB 문자열 (예: 녹색의 경우 '#00FF00') 다각형 도형에만 적용됩니다.
`fillOpacity optional`	유형: `number optional` 0.0과 1.0 사이의 채우기 불투명도입니다. 다각형 도형에만 적용됩니다.
`strokeColor optional`	유형: `string optional` 16진수 RGB 문자열 (예: 녹색의 경우 '#00FF00')
`strokeOpacity optional`	유형: `number optional` 0.0과 1.0 사이의 획 불투명도입니다. 선 및 다각형 도형에만 적용됩니다.
`strokeWeight optional`	유형: `number optional` 픽셀 단위의 스트로크 너비입니다. 선 및 다각형 도형에만 적용됩니다.

기능 인터페이스

google.maps.Feature 인터페이스

벡터 지도 타일 지형지물을 나타내는 인터페이스입니다. 이는 FeatureStyleFunction의 입력입니다. 특정 Feature 객체에 대한 참조를 저장하지 마세요. 참조가 안정적이지 않기 때문입니다.

속성
`featureType`	유형: `FeatureType` 이 `Feature`의 `FeatureType`입니다.

PlaceFeature 인터페이스

google.maps.PlaceFeature 인터페이스

장소 ID가 있는 지형지물을 나타내는 인터페이스로, FeatureType.ADMINISTRATIVE_AREA_LEVEL_1, FeatureType.ADMINISTRATIVE_AREA_LEVEL_2, FeatureType.COUNTRY, FeatureType.LOCALITY, FeatureType.POSTAL_CODE, FeatureType.SCHOOL_DISTRICT 유형의 지형지물이 포함됩니다.

이 인터페이스는 Feature를 확장합니다.

속성
`placeId`	유형: `string` `PlaceResult.place_id`
상속: `featureType`

메서드
`fetchPlace`	`fetchPlace()` 매개변수: 없음 반환 값: `Promise<Place>` 이 `PlaceFeature`의 `Place`를 가져옵니다. 결과 `Place` 객체에서 `id` 및 `displayName` 속성이 채워집니다. 표시 이름은 최종 사용자가 지도에 보는 언어로 표시됩니다. 일반 Places API 사용 설정 및 결제에 따라 `Place.fetchFields()`를 통해 추가 필드를 요청할 수 있습니다. 동기식 FeatureStyleFunctions만 지원되므로 `FeatureStyleFunction`에서 호출하지 마세요. `Place` 가져오기에 오류가 있으면 프로미스가 거부됩니다.

메서드

fetchPlace

fetchPlace()

매개변수: 없음

반환 값: Promise<Place>

이 PlaceFeature의 Place를 가져옵니다. 결과 Place 객체에서 id 및 displayName 속성이 채워집니다. 표시 이름은 최종 사용자가 지도에 보는 언어로 표시됩니다. 일반 Places API 사용 설정 및 결제에 따라 Place.fetchFields()를 통해 추가 필드를 요청할 수 있습니다. 동기식 FeatureStyleFunctions만 지원되므로 FeatureStyleFunction에서 호출하지 마세요. Place 가져오기에 오류가 있으면 프로미스가 거부됩니다.

DatasetFeature 인터페이스

google.maps.DatasetFeature 인터페이스

데이터 세트의 지형지물을 나타내는 인터페이스입니다. DatasetFeature의 featureType는 항상 FeatureType.DATASET입니다.

이 인터페이스는 Feature를 확장합니다.

속성
`datasetAttributes`	유형: `Object<string, string>` 지형지물의 속성 키-값 매핑입니다.
`datasetId`	유형: `string` 이 지형지물이 속한 데이터 세트의 데이터 세트 ID입니다.
상속: `featureType`

FeatureMouseEvent 인터페이스

google.maps.FeatureMouseEvent 인터페이스

이 객체는 FeatureLayer의 마우스 이벤트에서 반환됩니다.

이 인터페이스는 MapMouseEvent를 확장합니다.

속성
`features`	유형: `Array<Feature>` 이 마우스 이벤트의 `Feature`입니다.
상속: `domEvent`, `latLng`

메서드
상속: `stop`