공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ui.Map.setOptions
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google 지도 기본 지도를 수정합니다. 다음 작업을 허용합니다. 1) 현재 MapType 설정 2) 기본 지도에 맞춤 스타일 제공 (MapTypeStyles) 3) 기본 지도에 사용할 수 있는 mapTypesIds 목록을 설정합니다.
매개변수 없이 호출되면 지도 유형을 Google 지도 기본값으로 재설정합니다.
이 ui.Map을 반환합니다.
사용 | 반환 값 |
---|
Map.setOptions(mapTypeId, styles, types) | ui.Map |
인수 | 유형 | 세부정보 |
---|
다음과 같은 경우: ui.map | ui.Map | ui.Map 인스턴스입니다. |
mapTypeId | 문자열, 선택사항 | 기본 지도를 설정할 mapTypeId입니다. 표준 Google Maps API 지도 유형 중 하나를 선택하려면 'ROADMAP', 'SATELLITE', 'HYBRID' 또는 'TERRAIN' 중 하나를 사용하거나 opt_styles 사전에서 지정된 키 중 하나를 사용할 수 있습니다. null로 두고 opt_styles에 스타일이 하나만 지정된 경우 해당 스타일이 사용됩니다. |
styles | 객체, 선택사항 | 지도에 표시되는 이름으로 키가 지정된 맞춤 MapTypeStyle 객체의 사전입니다. https://developers.google.com/maps/documentation/javascript/reference#MapTypeStyle을 참고하세요. |
types | List<String>, 선택사항 | 사용할 수 있는 mapTypeIds 목록입니다. 생략되었지만 opt_styles가 지정된 경우 모든 스타일 키를 표준 Google 지도 API 지도 유형에 추가합니다. |
예
코드 편집기 (JavaScript)
// Set the map to terrain with a string.
Map.setOptions('TERRAIN');
// Use a dictionary to add some typo protection.
var mapTypes = {
HYBRID: 'HYBRID',
ROADMAP: 'ROADMAP',
SATELLITE: 'SATELLITE',
TERRAIN: 'TERRAIN'
};
Map.setOptions({mapTypeId: mapTypes.HYBRID});
Map.setOptions({mapTypeId: mapTypes.ROADMAP});
Map.setOptions({mapTypeId: mapTypes.SATELLITE});
Map.setOptions({mapTypeId: mapTypes.TERRAIN});
// Add a basemap that inverts the lightness to make a darker background.
Map.setOptions({
styles:
{'Inverted': [{featureType: 'all', stylers: [{invert_lightness: true}]}]}
});
// Use types keyword to control map type visibility, e.g. show only 'Inverted'.
Map.setOptions({
styles:
{'Inverted': [{featureType: 'all', stylers: [{invert_lightness: true}]}]},
types: ['Inverted']
});
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eModifies the Google Maps basemap by setting the map type, providing custom styles, and controlling available map types.\u003c/p\u003e\n"],["\u003cp\u003eAccepts \u003ccode\u003emapTypeId\u003c/code\u003e, \u003ccode\u003estyles\u003c/code\u003e, and \u003ccode\u003etypes\u003c/code\u003e as parameters to customize the basemap's appearance and functionality.\u003c/p\u003e\n"],["\u003cp\u003eResets the map to the default Google Maps style if called without any parameters.\u003c/p\u003e\n"],["\u003cp\u003eAllows the use of standard Google Maps API map types ("ROADMAP", "SATELLITE", "HYBRID", "TERRAIN") or custom styles defined using MapTypeStyle objects.\u003c/p\u003e\n"],["\u003cp\u003eOffers flexibility in controlling the visibility of map types through the \u003ccode\u003etypes\u003c/code\u003e parameter.\u003c/p\u003e\n"]]],["This tool modifies the Google Maps basemap by setting the `mapTypeId` (e.g., \"ROADMAP\", \"SATELLITE\"). It allows custom styles (`MapTypeStyles`) via a dictionary, with user-defined names. Users can control available map types using a list of `mapTypeIds`. If no parameters are specified it defaults to the original Google Maps basemap. Example usage is shown, to set different Map Types, add a style (like Inverted) or control the displayed Map Types.\n"],null,["# ui.Map.setOptions\n\n\u003cbr /\u003e\n\nModifies the Google Maps basemap. Allows for: 1) Setting the current MapType. 2) Providing custom styles for the basemap (MapTypeStyles). 3) Setting the list of available mapTypesIds for the basemap.\n\n\u003cbr /\u003e\n\nIf called with no parameters, resets the map type to the Google Maps default.\n\nReturns this ui.Map.\n\n| Usage | Returns |\n|----------------------------------------------------------|---------|\n| Map.setOptions`(`*mapTypeId* `, `*styles* `, `*types*`)` | ui.Map |\n\n| Argument | Type | Details |\n|----------------|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `ui.map` | ui.Map | The ui.Map instance. |\n| `mapTypeId` | String, optional | A mapTypeId to set the basemap to. Can be one of \"ROADMAP\", \"SATELLITE\", \"HYBRID\", or \"TERRAIN\" to select one of the standard Google Maps API map types, or one of the keys specified in the opt_styles dictionary. If left as null and only 1 style is specified in opt_styles, that style will be used. |\n| `styles` | Object, optional | A dictionary of custom MapTypeStyle objects keyed with a name that will appear in the map's Map Type Controls. See: https://developers.google.com/maps/documentation/javascript/reference#MapTypeStyle |\n| `types` | List\\\u003cString\\\u003e, optional | A list of mapTypeIds to make available. If omitted, but opt_styles is specified, appends all of the style keys to the standard Google Maps API map types. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Set the map to terrain with a string.\nMap.setOptions('TERRAIN');\n\n// Use a dictionary to add some typo protection.\nvar mapTypes = {\n HYBRID: 'HYBRID',\n ROADMAP: 'ROADMAP',\n SATELLITE: 'SATELLITE',\n TERRAIN: 'TERRAIN'\n};\n\nMap.setOptions({mapTypeId: mapTypes.HYBRID});\nMap.setOptions({mapTypeId: mapTypes.ROADMAP});\nMap.setOptions({mapTypeId: mapTypes.SATELLITE});\nMap.setOptions({mapTypeId: mapTypes.TERRAIN});\n\n// Add a basemap that inverts the lightness to make a darker background.\nMap.setOptions({\n styles:\n {'Inverted': [{featureType: 'all', stylers: [{invert_lightness: true}]}]}\n});\n\n// Use types keyword to control map type visibility, e.g. show only 'Inverted'.\nMap.setOptions({\n styles:\n {'Inverted': [{featureType: 'all', stylers: [{invert_lightness: true}]}]},\n types: ['Inverted']\n});\n```"]]