새로운 지도 스타일이 곧 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` `Feature`가 스타일 지정을 위해 `FeatureStyleFunction`에 전달됩니다.

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` 픽셀 단위의 스트로크 너비입니다. 선과 다각형 도형에만 적용됩니다.

Feature 인터페이스

google.maps.Feature 인터페이스

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

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

PlaceFeature 인터페이스

google.maps.PlaceFeature 인터페이스

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

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

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

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

방법

fetchPlace

fetchPlace()

매개변수: 없음

반환 값: Promise<Place>

이 PlaceFeature의 Place를 가져옵니다. 결과로 반환되는 Place 객체에 id 및 displayName 속성이 채워집니다. 표시 이름은 지도에서 최종 사용자에게 표시되는 언어로 표시됩니다. 추가 필드는 일반적인 Places API 사용 설정 및 결제에 따라 Place.fetchFields()를 통해 나중에 요청할 수 있습니다. 동기 FeatureStyleFunction만 지원되므로 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`