Map.setOptions
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
نقشه پایه Google Maps را اصلاح می کند. اجازه می دهد برای:
1) تنظیم MapType فعلی. 2) ارائه سبک های سفارشی برای نقشه پایه (MapTypeStyles). 3) تنظیم لیست mapTypesIds موجود برای نقشه پایه.
اگر بدون پارامتر فراخوانی شود، نوع نقشه را به پیش فرض گوگل بازنشانی می کند.
نقشه را برمی گرداند.
| استفاده | برمی گرداند | Map.setOptions( mapTypeId , styles , types ) | ui.Map |
| استدلال | تایپ کنید | جزئیات | mapTypeId | رشته، اختیاری | یک mapTypeId برای تنظیم نقشه پایه. می تواند یکی از «ROADMAP»، «SATELLITE»، «HYBRID» یا «TERRAIN» برای انتخاب یکی از انواع نقشه استاندارد Google Maps API یا یکی از کلیدهای مشخص شده در فرهنگ لغت opt_styles باشد. اگر تهی باقی بماند و فقط 1 سبک در opt_styles مشخص شود، از آن سبک استفاده می شود. |
styles | شیء، اختیاری | فرهنگ لغت اشیاء MapTypeStyle سفارشی با نامی که در کنترل‌های نوع نقشه نقشه ظاهر می‌شود. ببینید: https://developers.google.com/maps/documentation/javascript/reference#MapTypeStyle |
types | List<String>، اختیاری است | فهرستی از mapTypeIds برای در دسترس قرار دادن. اگر حذف شود، اما opt_styles مشخص شده باشد، همه کلیدهای سبک را به انواع نقشه استاندارد Google Maps API اضافه می کند. |
نمونه ها
ویرایشگر کد (جاوا اسکریپت)
// Types
Map.setOptions('HYBRID');
Map.setOptions('ROADMAP');
Map.setOptions('SATELLITE');
Map.setOptions('TERRAIN');
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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 parameters to change the basemap's appearance or resets to the default Google Maps style when called without parameters.\u003c/p\u003e\n"],["\u003cp\u003eOffers flexibility in styling through custom MapTypeStyle objects and allows for selection from standard Google Maps API map types or custom styles.\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003esetOptions()\u003c/code\u003e method with arguments for mapTypeId, styles, and types to implement the modifications.\u003c/p\u003e\n"],["\u003cp\u003eReturns the ui.Map object after applying the specified options.\u003c/p\u003e\n"]]],["This function, `Map.setOptions()`, modifies the Google Maps basemap. It can set the `mapTypeId` to \"ROADMAP,\" \"SATELLITE,\" \"HYBRID,\" or \"TERRAIN,\" or to a custom style from the `styles` dictionary. Custom styles (`styles`) are defined as `MapTypeStyle` objects. The available `mapTypeIds` displayed in the basemap can be defined in `types`. If called without arguments, the function reverts to the default Google map type. It returns the modified `ui.Map` object.\n"],null,["# Map.setOptions\n\n\u003cbr /\u003e\n\nModifies the Google Maps basemap. Allows for:\n\n\u003cbr /\u003e\n\n1) Setting the current MapType. 2) Providing custom styles for the basemap (MapTypeStyles). 3) Setting the list of available mapTypesIds for the basemap.\n\nIf called with no parameters, resets the map type to the google default.\n\nReturns the map.\n\n| Usage | Returns |\n|----------------------------------------------------------|---------|\n| `Map.setOptions(`*mapTypeId* `, `*styles* `, `*types*`)` | ui.Map |\n\n| Argument | Type | Details |\n|-------------|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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// Types\nMap.setOptions('HYBRID');\nMap.setOptions('ROADMAP');\nMap.setOptions('SATELLITE');\nMap.setOptions('TERRAIN');\n```"]]
