إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
Map.setOptions
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعدّل هذه السمة الخريطة الأساسية في "خرائط Google". تسمح بما يلي:
1) ضبط MapType الحالي 2) توفير أنماط مخصّصة للخريطة الأساسية (MapTypeStyles) 3) ضبط قائمة mapTypesIds المتاحة للخريطة الأساسية
إذا تم استدعاؤها بدون مَعلمات، ستعيد ضبط نوع الخريطة على الإعداد التلقائي في Google.
تعرض هذه السمة الخريطة.
| الاستخدام | المرتجعات |
|---|
Map.setOptions(mapTypeId, styles, types) | ui.Map |
| الوسيطة | النوع | التفاصيل |
|---|
mapTypeId | سلسلة، اختياري | تمثّل هذه السمة نوع الخريطة الأساسية المطلوب ضبطها. يمكن أن تكون إحدى القيم التالية: "ROADMAP" أو "SATELLITE" أو "HYBRID" أو "TERRAIN" لاختيار أحد أنواع الخرائط العادية في Google Maps API، أو أحد المفاتيح المحدّدة في قاموس opt_styles. إذا تم تركها فارغة وتم تحديد نمط واحد فقط في opt_styles، سيتم استخدام هذا النمط. |
styles | الكائن، اختياري | قاموس لعناصر MapTypeStyle المخصّصة التي يتم تحديد مفاتيحها باسم سيظهر في عناصر التحكّم في نوع الخريطة. يُرجى الاطّلاع على: https://developers.google.com/maps/documentation/javascript/reference#MapTypeStyle |
types | List<String>, اختياري | قائمة بمعرّفات mapTypeIds التي يجب إتاحتها. في حال عدم تضمينها، ولكن تم تحديد opt_styles، يتم إلحاق جميع مفاتيح الأنماط بأنواع الخرائط العادية في Google Maps API. |
أمثلة
محرّر الرموز البرمجية (JavaScript)
// Types
Map.setOptions('HYBRID');
Map.setOptions('ROADMAP');
Map.setOptions('SATELLITE');
Map.setOptions('TERRAIN');
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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```"]]
