إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل هذا النمط في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد لمنصّة "خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Maps

فئة الخريطة

google.maps.Map class

يمتدّ هذا الصف إلى MVCObject.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Map} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`Map`	`Map(mapDiv[, opts])` المَعلمات: `mapDiv`: `HTMLElement` سيتم عرض الخريطة لملء هذا العنصر. `opts`: `MapOptions optional` الخيارات لإنشاء خريطة جديدة داخل حاوية HTML المحدّدة، والتي تكون عادةً عنصر `DIV`

الثوابت
`DEMO_MAP_ID`	رقم تعريف الخريطة الذي يمكن استخدامه مع نماذج الرموز البرمجية التي تتطلّب رقم تعريف الخريطة لا يُقصد استخدام معرّف الخريطة هذا في التطبيقات العلنية ولا يمكن استخدامه للميزات التي تتطلّب ضبط السحابة الإلكترونية (مثل Cloud Styling).

الثوابت

DEMO_MAP_ID رقم تعريف الخريطة الذي يمكن استخدامه مع نماذج الرموز البرمجية التي تتطلّب رقم تعريف الخريطة لا يُقصد استخدام معرّف الخريطة هذا في التطبيقات العلنية ولا يمكن استخدامه للميزات التي تتطلّب ضبط السحابة الإلكترونية (مثل Cloud Styling).

الخصائص
`controls`	النوع: `Array<MVCArray<HTMLElement>>` عناصر تحكّم إضافية لإرفاقها بالخريطة لإضافة عنصر تحكّم إلى الخريطة، أضِف `<div>` عنصر التحكّم إلى `MVCArray` المرتبط بـ `ControlPosition` حيث يجب عرض العنصر.
`data`	النوع: `Data` مثيل `Data` مرتبط بالخريطة أضِف ميزات إلى عنصر `Data` هذا لعرضها بسهولة على هذه الخريطة.
`mapTypes`	النوع: `MapTypeRegistry` قاعدة بيانات مسجّلين لعمليات إنشاء `MapType` حسب رقم تعريف السلسلة
`overlayMapTypes`	النوع: `MVCArray<MapType optional>` أنواع خرائط إضافية لاستخدامها كطبقة سيتم عرض أنواع الخرائط التي تتداخل فوق الخريطة الأساسية التي تم إرفاقها بها، بالترتيب الذي تظهر به في صفيف `overlayMapTypes` (يتم عرض التراكبات التي تحتوي على قيم فهرس أعلى أمام التراكبات التي تحتوي على قيم فهرس أقل).

الطُرق
`fitBounds`	`fitBounds(bounds[, padding])` المَعلمات: `bounds`: `LatLngBounds\|LatLngBoundsLiteral` الحدود المراد عرضها ‫`padding`: `number\|Padding optional` مقدار المسافة الفارغة بالبكسل. سيتمّ ملاءمة الحدود في الجزء المتبقّي من الخريطة بعد إزالة الحشو. ستؤدي القيمة الرقمية إلى إضافة مقدار الحشو نفسه على جميع الجوانب الأربعة. أدخِل القيمة 0 هنا لجعل fitBounds لا تتغيّر عند تكرار طلبها في نتيجة getBounds. القيمة المعروضة: لا شيء تُستخدَم لضبط إطار العرض بحيث يتضمّن الحدود المحدّدة. ملاحظة: عند ضبط الخريطة على `display: none`، تقرأ الدالة `fitBounds` حجم الخريطة على أنّه 0x0، وبالتالي لا تُجري أيّ عملية. لتغيير إطار العرض عندما تكون الخريطة مخفية، اضبط الخريطة على `visibility: hidden`، ما يضمن أن يكون لعنصر div الخاص بالخريطة حجمًا فعليًا. بالنسبة إلى الخرائط المتّجهية، تضبط هذه الطريقة ميل الخريطة واتجاهها على القيم التلقائية وهي صفر. قد يؤدي استدعاء هذه الطريقة إلى ظهور حركة سلسة أثناء تمرير الخريطة وتكبيرها أو تصغيرها لتلائم الحدود. تعتمد إمكانية استخدام هذه الطريقة لإضافة مؤثرات متحركة على قاعدة داخلية.
`getBounds`	`getBounds()` المَعلمات: بدون القيمة المعروضة: `LatLngBounds\|undefined` حدود خطي الطول والعرض لإطار العرض الحالي. لعرض حدود خط العرض/خط الطول لإطار العرض الحالي. إذا كانت أكثر من نسخة واحدة من الكرة الأرضية مرئية، تتراوح حدود خط الطول بين -180 و180 درجة شاملة. إذا لم يتمّ إعداد الخريطة بعد أو لم يتمّ ضبط مركزها ودرجة تكبيرها، تكون النتيجة `undefined`. بالنسبة إلى الخرائط المتجهّة التي يكون فيها الإمالة أو الاتجاه غير صفريَين، تمثّل حدود خطي الطول والعرض المعروضَين أصغر مربّع حدود يتضمّن المنطقة المرئية في إطار عرض الخريطة. راجِع `MapCanvasProjection.getVisibleRegion` للحصول على المنطقة المرئية المحدّدة لإطار عرض الخريطة.
`getCenter`	`getCenter()` المَعلمات: بدون القيمة المعروضة: `LatLng\|undefined` تعرِض هذه السمة الموضع المعروض في وسط الخريطة. يُرجى العلم أنّ عنصر `LatLng` هذا غير ملفوف. يمكنك الاطّلاع على `LatLng` للحصول على المزيد من المعلومات. إذا لم يتم ضبط المركز أو الحدود، تكون النتيجة `undefined`.
`getClickableIcons`	`getClickableIcons()` المَعلمات: بدون القيمة المعروضة: `boolean\|undefined` لعرض إمكانية النقر على رموز الخريطة. يمثّل رمز الخريطة نقطة اهتمام، وتُعرف أيضًا باسم نقطة الاهتمام. إذا كانت القيمة المعروضة هي `true`، يعني ذلك أنّه يمكن النقر على الرموز على الخريطة.
`getDatasetFeatureLayer`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `getDatasetFeatureLayer(datasetId)` المَعلمات: `datasetId`: `string` القيمة المعروضة: `FeatureLayer` لعرض `FeatureLayer` لل`datasetId` المحدّد. يجب ضبط أرقام تعريف مجموعات البيانات في Google Cloud Console. إذا لم يكن رقم تعريف مجموعة البيانات مرتبطًا بأسلوب الخريطة، أو إذا لم يكن التصميم المستنِد إلى البيانات متاحًا (بدون رقم تعريف خريطة أو بلا وحدات تصفّح متجاوبة أو بلا طبقات عناصر أو مجموعات بيانات مصمّمة بالاستناد إلى البيانات في أسلوب الخريطة)، سيتم تسجيل خطأ، وسيكون `FeatureLayer.isAvailable` الناتج خطأ.
`getDiv`	`getDiv()` المَعلمات: بدون القيمة المعروضة: `HTMLElement` عنصر mapDiv الخاص بالخريطة.
`getFeatureLayer`	`getFeatureLayer(featureType)` المَعلمات: `featureType`: `FeatureType` القيمة المعروضة: `FeatureLayer` لعرض `FeatureLayer` لل`FeatureType` المحدّد. يجب تفعيل `FeatureLayer` في Google Cloud Console. إذا لم يكن هناك `FeatureLayer` لل`FeatureType` المحدّد على هذه الخريطة، أو إذا لم يكن التصميم المستنِد إلى البيانات متاحًا (بدون معرّف خريطة أو بلا وحدات تصفّح متجاوبة وبدون `FeatureLayer` مفعَّل في نمط الخريطة)، سيتم تسجيل خطأ، وستكون قيمة `FeatureLayer.isAvailable` الناتجة خطأ.
`getHeading`	`getHeading()` المَعلمات: بدون القيمة المعروضة: `number\|undefined` لعرض اتجاه البوصلة للخريطة. يتم قياس قيمة العنوان بالدرجات (باتجاه عقارب الساعة) من الاتجاه الأساسي "الشمال". إذا لم يتمّ إعداد الخريطة بعد، تكون النتيجة `undefined`.
`getHeadingInteractionEnabled`	`getHeadingInteractionEnabled()` المَعلمات: بدون القيمة المعروضة: `boolean\|null` تعرِض ما إذا كانت تفاعلات العناوين مفعّلة. لا يكون هذا الخيار ساريًا إلا عندما تكون الخريطة خريطة متجهية. في حال عدم ضبطه في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان متاحًا).
`getInternalUsageAttributionIds`	`getInternalUsageAttributionIds()` المَعلمات: بدون القيمة المعروضة: `Iterable<string>\|null` تعرِض هذه السمة قائمة بمعرّفات تحديد المصدر للاستخدام، ما يساعد Google في معرفة المكتبات والعيّنات المفيدة للمطوّرين، مثل استخدام مكتبة تجميع العلامات.
`getMapCapabilities`	`getMapCapabilities()` المَعلمات: بدون القيمة المعروضة: `MapCapabilities` إبلاغ المتصل بالإمكانات الحالية المتاحة للخريطة استنادًا إلى معرّف الخريطة الذي تم تقديمه
`getMapTypeId`	`getMapTypeId()` المَعلمات: بدون القيمة المعروضة: `MapTypeId\|string\|undefined`
`getProjection`	`getProjection()` المَعلمات: بدون القيمة المعروضة: `Projection\|undefined` لعرض `Projection` الحالي. إذا لم يتمّ إعداد الخريطة بعد، تكون النتيجة `undefined`. استمع إلى حدث `projection_changed` وتحقّق من قيمته للتأكّد من أنّها ليست `undefined`.
`getRenderingType`	`getRenderingType()` المَعلمات: بدون القيمة المعروضة: `RenderingType` لعرض نوع العرض الحالي للخريطة.
`getStreetView`	`getStreetView()` المَعلمات: بدون القيمة المعروضة: `StreetViewPanorama` الصورة البانورامية المرتبطة بالخريطة. تعرِض هذه السمة `StreetViewPanorama` التلقائية المرتبطة بالخريطة، والتي قد تكون بانوراما تلقائية مضمّنة في الخريطة، أو البانوراما التي تم ضبطها باستخدام `setStreetView()`. ستظهر التغييرات التي تطرأ على `streetViewControl` في الخريطة عند عرض بانوراما محدودة.
`getTilt`	`getTilt()` المَعلمات: بدون القيمة المعروضة: `number\|undefined` تعرِض هذه السمة الزاوية الحالية للانكسار في الخريطة، بالدرجات من مستوى إطار العرض إلى مستوى الخريطة. بالنسبة إلى الخرائط النقطية، ستكون النتيجة `0` للصور التي تم التقاطها مباشرةً من الأعلى أو `45` للصور التي تم التقاطها بزاوية 45 درجة. لا تُرجع هذه الطريقة القيمة التي تم ضبطها باستخدام `setTilt`. يُرجى الاطّلاع على `setTilt` لمعرفة التفاصيل.
`getTiltInteractionEnabled`	`getTiltInteractionEnabled()` المَعلمات: بدون القيمة المعروضة: `boolean\|null` تعرِض ما إذا كانت تفاعلات الانحناء مفعّلة. لا يكون هذا الخيار ساريًا إلا عندما تكون الخريطة خريطة متجهية. في حال عدم ضبطه في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان متاحًا).
`getZoom`	`getZoom()` المَعلمات: بدون القيمة المعروضة: `number\|undefined` تعرِض هذه السمة مستوى تكبير الخريطة. إذا لم يتم ضبط مستوى التكبير/التصغير، تكون النتيجة `undefined`.
`moveCamera`	`moveCamera(cameraOptions)` المَعلمات: `cameraOptions`: `CameraOptions` القيمة المعروضة: لا شيء ضبط كاميرا الخريطة على خيارات الكاميرا المستهدَفة على الفور بدون استخدام الصور المتحركة
`panBy`	`panBy(x, y)` المَعلمات: `x`: `number` عدد البكسل لنقل الخريطة في اتجاه x `y`: `number` عدد وحدات البكسل لنقل الخريطة في اتجاه y القيمة المعروضة: لا شيء يغيّر مركز الخريطة حسب المسافة المحدّدة بالبكسل. إذا كانت المسافة أقل من عرض الخريطة وارتفاعها، سيتم الانتقال بسلاسة. يُرجى العِلم أنّ نظام إحداثيات الخريطة يزداد من الغرب إلى الشرق (لقيم x) ومن الشمال إلى الجنوب (لقيم y).
`panTo`	`panTo(latLng)` المَعلمات: `latLng`: `LatLng\|LatLngLiteral` خط العرض/خط الطول الجديدان لمركز الخريطة القيمة المعروضة: لا شيء لتغيير مركز الخريطة إلى `LatLng` المحدّد إذا كان التغيير أقل من عرض الخريطة وارتفاعها، سيتم الانتقال بسلاسة باستخدام رسوم متحركة.
`panToBounds`	`panToBounds(latLngBounds[, padding])` المَعلمات: ‫`latLngBounds`: `LatLngBounds\|LatLngBoundsLiteral` الحدود التي يتم تمرير الخريطة إليها ‫`padding`: `number\|Padding optional` مقدار المسافة الفارغة بالبكسل. ستؤدي القيمة الرقمية إلى إضافة مقدار الحشو نفسه على جميع الجوانب الأربعة. القيمة التلقائية هي 0. القيمة المعروضة: لا شيء تمرير الخريطة بالقدر الأدنى اللازم لتضمين `LatLngBounds` المحدَّد ولا يمكن ضمان مكان ظهور الحدود على الخريطة، باستثناء أنّه سيتم تمرير الخريطة لعرض أكبر قدر ممكن من الحدود داخل `{currentMapSizeInPx} - {padding}`. بالنسبة إلى كلّ من الخرائط النقطية والمتجهة، لن يتم تغيير التكبير أو التصغير أو الإمالة أو العنوان في الخريطة.
`setCenter`	`setCenter(latlng)` المَعلمات: `latlng`: `LatLng\|LatLngLiteral` القيمة المعروضة: لا شيء
`setClickableIcons`	`setClickableIcons(value)` المَعلمات: `value`: `boolean` القيمة المعروضة: لا شيء يتحكّم هذا الخيار في إمكانية النقر على رموز الخريطة. يمثّل رمز الخريطة نقطة اهتمام، وتُعرف أيضًا باسم نقطة الاهتمام. لإيقاف إمكانية النقر على رموز الخريطة، مرِّر القيمة `false` إلى هذه الطريقة.
`setHeading`	`setHeading(heading)` المَعلمات: `heading`: `number` القيمة المعروضة: لا شيء لضبط اتجاه البوصلة للخريطة، يتم قياسه بالدرجات من الاتجاه الأساسي الشمال. بالنسبة إلى الخرائط المركّبة من وحدات بكسل، لا تنطبق هذه الطريقة إلا على الصور الجوية.
`setHeadingInteractionEnabled`	`setHeadingInteractionEnabled(headingInteractionEnabled)` المَعلمات: `headingInteractionEnabled`: `boolean` القيمة المعروضة: لا شيء يحدّد ما إذا كانت تفاعلات العناوين مفعّلة. لا يكون هذا الخيار ساريًا إلا عندما تكون الخريطة خريطة متجهية. في حال عدم ضبطه في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان متاحًا).
`setMapTypeId`	`setMapTypeId(mapTypeId)` المَعلمات: `mapTypeId`: `MapTypeId\|string` القيمة المعروضة: لا شيء
`setOptions`	`setOptions(options)` المَعلمات: `options`: `MapOptions optional` القيمة المعروضة: لا شيء
`setRenderingType`	`setRenderingType(renderingType)` المَعلمات: `renderingType`: `RenderingType` القيمة المعروضة: لا شيء لضبط RenderingType الحالي للخريطة.
`setStreetView`	`setStreetView(panorama)` المَعلمات: ‫`panorama`: `StreetViewPanorama optional` البانوراما المطلوب ربطها بالخريطة القيمة المعروضة: لا شيء ربط `StreetViewPanorama` بالخريطة تلغي هذه البانوراما `StreetViewPanorama` التلقائية، ما يسمح بربط الخريطة ببانوراما خارجية خارج الخريطة. يؤدي ضبط الصورة البانورامية على `null` إلى ربط الصورة البانورامية المضمّنة التلقائية مرة أخرى بالخريطة.
`setTilt`	`setTilt(tilt)` المَعلمات: `tilt`: `number` القيمة المعروضة: لا شيء بالنسبة إلى الخرائط الاتجاهية، يتم ضبط زاوية حدوث الخريطة. يتم حظر القيم المسموح بها استنادًا إلى مستوى تكبير الخريطة. بالنسبة إلى الخرائط المركّبة، تتحكّم هذه السمة في سلوك التبديل التلقائي لزاوية حدوث الخريطة. القيمتان الوحيدتان المسموح بهما هما `0` و`45`. يؤدي الخيار `setTilt(0)` إلى استخدام الخريطة دائمًا لعرض علوي بزاوية 0 درجة بغض النظر عن مستوى التكبير وإطار العرض. يؤدي الضغط على `setTilt(45)` إلى تبديل زاوية الميل تلقائيًا إلى 45 درجة كلما توفّرت صور بزاوية 45 درجة لمستوى التكبير/التصغير الحالي ومساحة العرض، والعودة إلى 0 عندما لا تتوفّر صور بزاوية 45 درجة (هذا هو السلوك التلقائي). لا تتوفّر صور بزاوية 45 درجة إلا لأنواع الخرائط `satellite` و`hybrid`، وفي بعض المواقع الجغرافية، وبعض مستويات التكبير/التصغير. ملاحظة: تعرض دالة `getTilt` زاوية الميل الحالية، وليس القيمة التي تم ضبطها باستخدام دالة `setTilt`. بما أنّ `getTilt` و`setTilt` يشيران إلى أشياء مختلفة، لا `bind()` سمة `tilt`، لأنّ ذلك قد يؤدي إلى نتائج غير متوقّعة.
`setTiltInteractionEnabled`	`setTiltInteractionEnabled(tiltInteractionEnabled)` المَعلمات: `tiltInteractionEnabled`: `boolean` القيمة المعروضة: لا شيء لتحديد ما إذا كانت تفاعلات الانحناء مفعّلة لا يكون هذا الخيار ساريًا إلا عندما تكون الخريطة خريطة متجهية. في حال عدم ضبطه في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان متاحًا).
`setZoom`	`setZoom(zoom)` المَعلمات: `zoom`: `number` تتوافق قيم التكبير الأكبر مع دقة أعلى. القيمة المعروضة: لا شيء لضبط مستوى تكبير/تصغير الخريطة
مُكتسَبة: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

الفعاليات
`bounds_changed`	`function()` الوسيطات: بدون يتم تنشيط هذا الحدث عند تغيير حدود إطار العرض.
`center_changed`	`function()` الوسيطات: بدون يتمّ تشغيل هذا الحدث عند تغيير خاصيّة مركز الخريطة.
`click`	`function(event)` الوسيطات: `event`: `MapMouseEvent\|IconMouseEvent` يتمّ تشغيل هذا الحدث عندما ينقر المستخدِم على الخريطة. يتم عرض حدث MapMouseEvent يتضمّن سمات الموقع الجغرافي الذي تم النقر عليه ما لم يتم النقر على رمز مكان، وفي هذه الحالة يتم عرض حدث IconMouseEvent يتضمّن معرّف مكان. الحدثان IconMouseEvent وMapMouseEvent متطابقان، باستثناء أنّ الحدث IconMouseEvent يحتوي على حقل معرّف المكان. يمكن دائمًا التعامل مع الحدث على أنّه MapMouseEvent عندما لا يكون رقم تعريف المكان مهمًا. لا يتم تشغيل حدث النقر إذا تم النقر على علامة أو نافذة معلومات.
`contextmenu`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تشغيل هذا الحدث عند تشغيل حدث قائمة السياق في عنصر DOM على حاوية الخريطة.
`dblclick`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تشغيل هذا الحدث عندما ينقر المستخدم مرّتين على الخريطة. يُرجى العِلم أنّه سيتم تنشيط حدث النقرة أحيانًا مرّة وأحيانًا مرّتين، قبل هذا الحدث مباشرةً.
`drag`	`function()` الوسيطات: بدون يتم تشغيل هذا الحدث بشكل متكرّر بينما يسحب المستخدم الخريطة.
`dragend`	`function()` الوسيطات: بدون يتمّ تشغيل هذا الحدث عندما يتوقف المستخدِم عن سحب الخريطة. ملاحظة: لا يتم تشغيل dragend عندما يتوقف المستخدم عن تمرير الخريطة باستخدام لوحة المفاتيح. يُرجى استخدام الحدث `Map.idle` بدلاً من ذلك لتحديد وقت توقّف المستخدِم عن التمرير أو سحب الخريطة.
`dragstart`	`function()` الوسيطات: بدون يتم تشغيل هذا الحدث عندما يبدأ المستخدم سحب الخريطة.
`heading_changed`	`function()` الوسيطات: بدون يتم تشغيل هذا الحدث عند تغيير سمة عنوان الخريطة.
`idle`	`function()` الوسيطات: بدون يتم تنشيط هذا الحدث عندما تصبح الخريطة غير نشِطة بعد التمرير أو التكبير/التصغير.
`isfractionalzoomenabled_changed`	`function()` الوسيطات: بدون يتم تنشيط هذا الحدث عند تغيير السمة isFractionalZoomEnabled.
`mapcapabilities_changed`	`function()` الوسيطات: بدون يتم تنشيط هذا الحدث عند تغيير إمكانات الخريطة.
`maptypeid_changed`	`function()` الوسيطات: بدون يتم تنشيط هذا الحدث عند تغيير سمة mapTypeId.
`mousemove`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتمّ تشغيل هذا الحدث كلّما مرّ مؤشّر الماوس الخاص بالمستخدم فوق حاوية الخريطة.
`mouseout`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تشغيل هذا الحدث عندما يخرج مؤشر الماوس الخاص بالمستخدم من حاوية الخريطة.
`mouseover`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تشغيل هذا الحدث عندما يدخل ماوس المستخدم إلى حاوية الخريطة.
`projection_changed`	`function()` الوسيطات: بدون يتمّ تشغيل هذا الحدث عند تغيير الإسقاط.
`renderingtype_changed`	`function()` الوسيطات: بدون يتمّ تشغيل هذا الحدث عند تغيير renderingType.
`tilesloaded`	`function()` الوسيطات: بدون يتم تنشيط هذا الحدث عند انتهاء تحميل المربّعات المرئية.
`tilt_changed`	`function()` الوسيطات: بدون يتم تشغيل هذا الحدث عند تغيير خاصية إمالة الخريطة.
`zoom_changed`	`function()` الوسيطات: بدون يتمّ تشغيل هذا الحدث عند تغيير خاصيّة تكبير/تصغير الخريطة.
`rightclick`	متوقف نهائيًا: استخدِم الحدث `Map.contextmenu` بدلاً من ذلك لتتوافق مع أنماط الاستخدام، مثل النقر مع الضغط على مفتاح التحكّم (Control) في نظام التشغيل macOS. `function(event)` الوسيطات: `event`: `MapMouseEvent` يتمّ تشغيل هذا الحدث عندما ينقر المستخدِم بزرّ الماوس الأيمن على الخريطة.

واجهة MapOptions

google.maps.MapOptions واجهة

عنصر MapOptions المستخدَم لتحديد السمات التي يمكن ضبطها على خريطة

الخصائص
`backgroundColor optional`	النوع: `string optional` اللون المستخدَم لخلفية div للخريطة. سيظهر هذا اللون عندما لا يتم تحميل المربّعات بعد أثناء تمرير المستخدم للشاشة. لا يمكن ضبط هذا الخيار إلا عند بدء تشغيل الخريطة.
`cameraControl optional`	النوع: `boolean optional` حالة تفعيل/إيقاف عنصر التحكّم في الكاميرا
`cameraControlOptions optional`	النوع: `CameraControlOptions optional` خيارات العرض لعنصر التحكّم في الكاميرا
`center optional`	النوع: `LatLng\|LatLngLiteral optional` مركز الخريطة الأولي.
`clickableIcons optional`	النوع: `boolean optional` القيمة التلقائية: `true` عندما تكون القيمة `false`، لا يمكن النقر على رموز الخريطة. يمثّل رمز الخريطة نقطة اهتمام، وتُعرف أيضًا باسم نقطة الاهتمام.
`colorScheme optional`	النوع: `ColorScheme\|string optional` القيمة التلقائية: `ColorScheme.LIGHT` مخطّط الألوان الأوّلي للخريطة لا يمكن ضبط هذا الخيار إلا عند بدء تشغيل الخريطة.
`controlSize optional`	النوع: `number optional` حجم عناصر التحكّم التي تظهر على الخريطة بالبكسل يجب تقديم هذه القيمة مباشرةً عند إنشاء "الخريطة"، وقد يؤدي تعديل هذه القيمة لاحقًا إلى ضبط عناصر التحكّم على الحالة `undefined`. لا يسري إلا على عناصر التحكّم التي أنشأتها واجهة برمجة التطبيقات Maps API نفسها. لا يتمّ توسيع نطاق عناصر التحكّم المخصّصة التي أنشأها المطوّرون.
`disableDefaultUI optional`	النوع: `boolean optional` تفعيل/إيقاف جميع أزرار واجهة المستخدم التلقائية يمكن إلغاء هذه الإعدادات بشكلٍ فردي. لا يؤدي هذا الخيار إلى إيقاف عناصر التحكّم في لوحة المفاتيح، والتي يتم التحكّم فيها بشكل منفصل باستخدام الخيار `MapOptions.keyboardShortcuts`. لا يؤدي هذا الخيار إلى إيقاف عناصر التحكّم بالإيماءات، والتي يتم التحكّم فيها بشكل منفصل باستخدام الخيار `MapOptions.gestureHandling`.
`disableDoubleClickZoom optional`	النوع: `boolean optional` تفعيل/إيقاف التكبير والتوسيع والتركيز عند النقر مرّتين مفعَّل تلقائيًا ملاحظة: لا يُنصح باستخدام هذا الخيار. لإيقاف التكبير/التصغير عند النقر مرّتين، يمكنك استخدام السمة `gestureHandling` وضبطها على `"none"`.
`draggable optional`	متوقف نهائيًا: تم إيقافه نهائيًا في عام 2017. لإيقاف السحب على الخريطة، يمكنك استخدام السمة `gestureHandling` وضبطها على `"none"`. النوع: `boolean optional` إذا كان `false`، يمنع سحب الخريطة. تكون ميزة السحب مفعَّلة تلقائيًا.
`draggableCursor optional`	النوع: `string optional` اسم المؤشر أو عنوان URL المراد عرضه عند تمرير مؤشر الماوس فوق خريطة قابلة للسحب يستخدم هذا الموقع السمة `cursor` في ملفّ css لتغيير الرمز. كما هو الحال مع سمة css، يجب تحديد مؤشر احتياطي واحد على الأقل ليس عنوان URL. على سبيل المثال: `draggableCursor: 'url(http://www.example.com/icon.png), auto;'`.
`draggingCursor optional`	النوع: `string optional` اسم المؤشر أو عنوان URL المراد عرضه عند سحب الخريطة يستخدم هذا الموقع السمة `cursor` في ملفّ css لتغيير الرمز. كما هو الحال مع سمة css، يجب تحديد مؤشر احتياطي واحد على الأقل ليس عنوان URL. على سبيل المثال: `draggingCursor: 'url(http://www.example.com/icon.png), auto;'`.
`fullscreenControl optional`	النوع: `boolean optional` حالة تفعيل/إيقاف عنصر التحكّم في "ملء الشاشة"
`fullscreenControlOptions optional`	النوع: `FullscreenControlOptions optional` خيارات العرض لعنصر التحكّم "ملء الشاشة"
`gestureHandling optional`	النوع: `string optional` يتحكّم هذا الإعداد في كيفية تعامل واجهة برمجة التطبيقات مع الإيماءات على الخريطة. القيم المسموح بها: `"cooperative"`: تؤدي أحداث الانتقال إلى أعلى أو أسفل الصفحة وإيماءات اللمس باستخدام إصبع واحد إلى الانتقال إلى أعلى أو أسفل الصفحة، ولا تؤدي إلى تكبير الخريطة أو تصغيرها أو تمريرها. يمكنك استخدام إيماءات اللمس باستخدام إصبعين لتمرير الخريطة وتكبيرها أو تصغيرها. يمكنك الانتقال بين الأحداث مع الضغط على مفتاح Ctrl أو مفتاح ⌘ لتكبير الخريطة. في هذا الوضع، تتعاون الخريطة مع الصفحة. `"greedy"`: تعمل جميع إيماءات اللمس وأحداث التمرير على تمديد الخريطة أو تصغيرها. `"none"`: لا يمكن تحريك الخريطة أو تكبيرها أو تصغيرها باستخدام إيماءات المستخدم. ‫`"auto"`: (الإعداد التلقائي) يكون التعامل مع الإيماءات إما تعاونيًا أو جشعًا، وذلك استنادًا إلى ما إذا كانت الصفحة قابلة للتقديم أو الإيقاف أو كانت في إطار iframe.
`heading optional`	النوع: `number optional` اتجاه الصور الجوية بالدرجات المقاسة في اتجاه عقارب الساعة من الاتجاه الأساسي الشمال يتمّ تثبيت العناوين على أقرب زاوية متاحة تتوفّر فيها صور.
`headingInteractionEnabled optional`	النوع: `boolean optional` القيمة التلقائية: `false` ما إذا كان يجب أن تسمح الخريطة للمستخدم بالتحكّم في اتجاه الكاميرا (الدوران) لا يكون هذا الخيار ساريًا إلا عندما تكون الخريطة خريطة متجهية. في حال عدم ضبطه في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان متاحًا).
`internalUsageAttributionIds optional`	النوع: `Iterable<string> optional` القيمة التلقائية: `null` تُضيف هذه الميزة معرّفًا لتحديد مصدر الاستخدام إلى أداة الإعداد، ما يساعد Google في معرفة المكتبات والعيّنات المفيدة للمطوّرين، مثل استخدام مكتبة لتجميع العلامات. لإيقاف إرسال رقم تعريف تحديد المصدر للاستخدام، يمكنك بأمان حذف هذا السمة أو استبدال القيمة بسلسلة فارغة. سيتم إرسال القيم الفريدة فقط. قد يتم تجاهل التغييرات التي تطرأ على هذه القيمة بعد إنشاء العنصر.
`isFractionalZoomEnabled optional`	النوع: `boolean optional` الإعداد التلقائي: `true` للخرائط المتجهّة و`false` للخرائط النقطية ما إذا كان يجب أن تسمح الخريطة بمستويات تكبير / تصغير جزئية استمع إلى `isfractionalzoomenabled_changed` لمعرفة وقت ضبط الإعداد التلقائي.
`keyboardShortcuts optional`	النوع: `boolean optional` إذا كان `false`، يمنع التحكّم في الخريطة باستخدام لوحة المفاتيح. تكون اختصارات لوحة المفاتيح مفعّلة تلقائيًا.
`mapId optional`	النوع: `string optional` معرّف الخريطة لا يمكن ضبط هذه المَعلمة أو تغييرها بعد إنشاء خريطة. يمكن استخدام `Map.DEMO_MAP_ID` لتجربة الميزات التي تتطلّب معرّف خريطة ولكنّها لا تتطلّب تفعيل السحابة الإلكترونية.
`mapTypeControl optional`	النوع: `boolean optional` الحالة الأولية لتفعيل/إيقاف عنصر التحكّم في نوع الخريطة
`mapTypeControlOptions optional`	النوع: `MapTypeControlOptions optional` خيارات العرض الأولية لعنصر التحكّم "نوع الخريطة"
`mapTypeId optional`	النوع: `MapTypeId\|string optional` نوع الخريطة mapTypeId الأولي. الإعداد التلقائي هو `ROADMAP`.
`maxZoom optional`	النوع: `number optional` الحد الأقصى لمستوى التكبير أو التصغير الذي سيتم عرضه على الخريطة في حال حذف هذا الحقل أو ضبطه على `null`، يتم استخدام الحد الأقصى للتكبير من نوع الخريطة الحالي بدلاً من ذلك. قيم التكبير أو التصغير الصالحة هي أرقام من صفر إلى الحد الأقصى المسموح به لمستوى التكبير أو التصغير.
`minZoom optional`	النوع: `number optional` الحد الأدنى لمستوى التكبير الذي سيتم عرضه على الخريطة في حال حذف هذا الحقل أو ضبطه على `null`، سيتم استخدام الحد الأدنى للتكبير من نوع الخريطة الحالي بدلاً من ذلك. قيم التكبير أو التصغير الصالحة هي أرقام من صفر إلى الحد الأقصى المسموح به لمستوى التكبير أو التصغير.
`noClear optional`	النوع: `boolean optional` في حال `true`، لا تُفرِغ محتوى div الخاص بالخريطة.
`panControl optional`	تم إيقافه نهائيًا: تم إيقاف عنصر التحكّم في التمرير نهائيًا اعتبارًا من أيلول (سبتمبر) 2015. النوع: `boolean optional` حالة تفعيل/إيقاف عنصر التحكّم في العرض الشامل
`panControlOptions optional`	تم إيقافه نهائيًا: تم إيقاف عنصر التحكّم في التمرير نهائيًا اعتبارًا من أيلول (سبتمبر) 2015. النوع: `PanControlOptions optional` خيارات العرض عنصر التحكّم في العرض الشامل
`renderingType optional`	النوع: `RenderingType optional` القيمة التلقائية: `RenderingType.RASTER` ما إذا كانت الخريطة نقطية أو متجهية لا يمكن ضبط هذه المَعلمة أو تغييرها بعد إنشاء خريطة. في حال عدم ضبط القيمة، ستحدد إعدادات السحابة الإلكترونية لرقم تعريف الخريطة نوع العرض (إذا كان متاحًا). يُرجى العِلم أنّ الخرائط المتجهّة قد لا تكون متاحة لجميع الأجهزة والمتصفّحات، وستعود الخريطة إلى الخريطة النقطية عند الحاجة.
`restriction optional`	النوع: `MapRestriction optional` تُحدِّد حدودًا تحدّ من منطقة الخريطة التي يمكن للمستخدمين الوصول إليها. عند ضبطها، لا يمكن للمستخدم سوى التمرير السريع والتكبير/التصغير عندما تظلّ رؤية الكاميرا داخل حدود الحدود.
`rotateControl optional`	النوع: `boolean optional` حالة تفعيل/إيقاف عنصر التحكّم في التدوير
`rotateControlOptions optional`	النوع: `RotateControlOptions optional` خيارات العرض لعنصر التحكّم "التدوير"
`scaleControl optional`	النوع: `boolean optional` الحالة الأولية لتفعيل/إيقاف عنصر التحكّم في "الحجم"
`scaleControlOptions optional`	النوع: `ScaleControlOptions optional` خيارات العرض الأولية لعنصر التحكّم في "الحجم"
`scrollwheel optional`	النوع: `boolean optional` إذا كان `false`، يتم إيقاف ميزة التكبير/التصغير على الخريطة باستخدام عجلة التمرير في الماوس. يكون زر التمرير مفعّلاً تلقائيًا. ملاحظة: لا يُنصح باستخدام هذا الخيار. لإيقاف التكبير أو التصغير باستخدام عجلة التمرير، يمكنك استخدام السمة `gestureHandling` وضبطها على `"cooperative"` أو `"none"`.
`streetView optional`	النوع: `StreetViewPanorama optional` `StreetViewPanorama` لعرضه عند إسقاط الدليل في "التجوّل الافتراضي" على الخريطة في حال عدم تحديد صورة بانورامية، سيتم عرض `StreetViewPanorama` تلقائي في `div` الخريطة عند إسقاط رمز العارض.
`streetViewControl optional`	النوع: `boolean optional` الحالة الأولية للتشغيل/الإيقاف لعنصر التحكّم في "الدليل" في "التجوّل الافتراضي" يُعدّ عنصر التحكّم هذا جزءًا من واجهة المستخدم التلقائية، ويجب ضبطه على `false` عند عرض نوع خريطة لا يجب أن يظهر عليه تراكب الطرق في "التجوّل الافتراضي" (مثل نوع خريطة غير من Earth).
`streetViewControlOptions optional`	النوع: `StreetViewControlOptions optional` خيارات العرض الأولية لعنصر التحكّم في "الدليل" في "التجوّل الافتراضي"
`styles optional`	النوع: `Array<MapTypeStyle> optional` الأنماط التي سيتم تطبيقها على كل نوع من أنواع الخرائط التلقائية يُرجى العِلم أنّه في أوضاع `satellite`/`hybrid` و`terrain`، لن تنطبق هذه الأنماط إلا على التصنيفات والأشكال الهندسية. لا تتوفّر هذه الميزة عند استخدام رقم تعريف خريطة أو عند استخدام الخرائط المستندة إلى المتجهات (استخدِم تنسيق الخرائط المستندة إلى السحابة الإلكترونية بدلاً من ذلك).
`tilt optional`	النوع: `number optional` بالنسبة إلى الخرائط الاتجاهية، يتم ضبط زاوية حدوث الخريطة. يتم حظر القيم المسموح بها استنادًا إلى مستوى تكبير الخريطة. بالنسبة إلى الخرائط المركّبة، تتحكّم هذه السمة في سلوك التبديل التلقائي لزاوية حدوث الخريطة. القيمتان الوحيدتان المسموح بهما هما `0` و`45`. تؤدي القيمة `0` إلى استخدام الخريطة دائمًا لعرض علوي بزاوية 0 درجة بغض النظر عن مستوى التكبير وإطار العرض. تؤدي القيمة `45` إلى تبديل زاوية الميل تلقائيًا إلى 45 درجة كلما توفّرت صور بزاوية 45 درجة لمستوى التكبير/التصغير الحالي ومساحة العرض الحالية، كما تؤدي إلى الرجوع إلى القيمة 0 عندما لا تتوفّر صور بزاوية 45 درجة (هذا هو السلوك التلقائي). لا تتوفّر صور بزاوية 45 درجة إلا لأنواع الخرائط `satellite` و`hybrid`، وفي بعض المواقع الجغرافية، وبعض مستويات التكبير/التصغير. ملاحظة: تعرِض `getTilt` زاوية الميل الحالية، وليس القيمة المحدّدة بهذا الخيار. بما أنّ `getTilt` يشير إلى عناصر مختلفة عن هذا الخيار، لا `bind()` السمة `tilt`، لأنّ ذلك قد يؤدي إلى نتائج غير متوقّعة.
`tiltInteractionEnabled optional`	النوع: `boolean optional` القيمة التلقائية: `false` ما إذا كان يجب أن تسمح الخريطة للمستخدم بالتحكّم في إمالة الكاميرا لا يكون هذا الخيار ساريًا إلا عندما تكون الخريطة خريطة متجهية. في حال عدم ضبطه في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان متاحًا).
`zoom optional`	النوع: `number optional` مستوى التكبير أو التصغير الأولي للخريطة قيم التكبير أو التصغير الصالحة هي أرقام من صفر إلى الحد الأقصى المسموح به لمستوى التكبير أو التصغير. تتوافق قيم التكبير الأكبر مع دقة أعلى.
`zoomControl optional`	النوع: `boolean optional` حالة تفعيل/إيقاف عنصر التحكّم في التكبير/التصغير
`zoomControlOptions optional`	النوع: `ZoomControlOptions optional` خيارات العرض لعنصر التحكّم في التكبير/التصغير

فئة MapElement

google.maps.MapElement class

MapElement هي فئة فرعية من HTMLElement لعرض الخرائط. بعد تحميل مكتبة maps، يمكن إنشاء خريطة بتنسيق HTML. على سبيل المثال:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

يستخدم هذا الإجراء داخليًا Map، ويمكن الوصول إليه باستخدام السمة innerMap.

العنصر المخصّص:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

يمتدّ هذا الصف إلى HTMLElement.

تنفّذ هذه الفئة MapElementOptions.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {MapElement} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`MapElement`	`MapElement([options])` المَعلمات: `options`: `MapElementOptions optional`

الخصائص
`center`	النوع: `LatLng\|LatLngLiteral optional` خط العرض/خط الطول في وسط الخريطة سمة HTML: `<gmp-map center="lat,lng"></gmp-map>`
`headingInteractionDisabled`	النوع: `boolean optional` القيمة التلقائية: `false` ما إذا كان يجب أن تسمح الخريطة للمستخدم بالتحكّم في اتجاه الكاميرا (الدوران) لا يكون هذا الخيار ساريًا إلا عندما تكون الخريطة خريطة متجهية. في حال عدم ضبطه في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان متاحًا). سمة HTML: `<gmp-map heading-interaction-disabled></gmp-map>`
`innerMap`	النوع: `Map` إشارة إلى `Map` الذي يستخدمه MapElement داخليًا.
`internalUsageAttributionIds`	النوع: `Iterable<string> optional` القيمة التلقائية: `null` تُضيف هذه الميزة معرّفًا لتحديد مصدر الاستخدام إلى أداة الإعداد، ما يساعد Google في معرفة المكتبات والعيّنات المفيدة للمطوّرين، مثل استخدام مكتبة لتجميع العلامات. لإيقاف إرسال رقم تعريف تحديد المصدر للاستخدام، يمكنك بأمان حذف هذا السمة أو استبدال القيمة بسلسلة فارغة. سيتم إرسال القيم الفريدة فقط. قد يتم تجاهل التغييرات التي تطرأ على هذه القيمة بعد إنشاء العنصر. سمة HTML: `<gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>`
`mapId`	النوع: `string optional` معرّف الخريطة لا يمكن ضبط هذه المَعلمة أو تغييرها بعد إنشاء خريطة. يمكن استخدام `Map.DEMO_MAP_ID` لتجربة الميزات التي تتطلّب معرّف خريطة ولكنّها لا تتطلّب تفعيل السحابة الإلكترونية. سمة HTML: `<gmp-map map-id="string"></gmp-map>`
`renderingType`	النوع: `RenderingType optional` القيمة التلقائية: `RenderingType.VECTOR` ما إذا كانت الخريطة نقطية أو متجهية لا يمكن ضبط هذه المَعلمة أو تغييرها بعد إنشاء خريطة. في حال عدم ضبط القيمة، ستحدد إعدادات السحابة الإلكترونية لرقم تعريف الخريطة نوع العرض (إذا كان متاحًا). يُرجى العِلم أنّ الخرائط المتجهّة قد لا تكون متاحة لجميع الأجهزة والمتصفّحات، وستعود الخريطة إلى الخريطة النقطية عند الحاجة. سمة HTML: `<gmp-map rendering-type="vector"></gmp-map>` `<gmp-map rendering-type="raster"></gmp-map>`
`tiltInteractionDisabled`	النوع: `boolean optional` القيمة التلقائية: `false` ما إذا كان يجب أن تسمح الخريطة للمستخدم بالتحكّم في إمالة الكاميرا لا يكون هذا الخيار ساريًا إلا عندما تكون الخريطة خريطة متجهية. في حال عدم ضبطه في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان متاحًا). سمة HTML: `<gmp-map tilt-interaction-disabled></gmp-map>`
`zoom`	النوع: `number optional` مستوى تكبير الخريطة. قيم التكبير أو التصغير الصالحة هي أرقام من صفر إلى الحد الأقصى المسموح به لمستوى التكبير أو التصغير. تتوافق قيم التكبير الأكبر مع دقة أعلى. سمة HTML: `<gmp-map zoom="number"></gmp-map>`

الماكينات الشقبية
`control-block-end-inline-center`	تضع العنصر المُسنَد في الموضع `ControlPosition.BLOCK_END_INLINE_CENTER`.
`control-block-end-inline-end`	تضع العنصر المُسنَد في الموضع `ControlPosition.BLOCK_END_INLINE_END`.
`control-block-end-inline-start`	تضع العنصر المُسنَد في الموضع `ControlPosition.BLOCK_END_INLINE_START`.
`control-block-start-inline-center`	تضع العنصر المُسنَد في الموضع `ControlPosition.BLOCK_START_INLINE_CENTER`.
`control-block-start-inline-end`	تضع العنصر المُسنَد في الموضع `ControlPosition.BLOCK_START_INLINE_END`.
`control-block-start-inline-start`	تضع العنصر المُسنَد في الموضع `ControlPosition.BLOCK_START_INLINE_START`.
`control-inline-end-block-center`	تضع العنصر المُسنَد في الموضع `ControlPosition.INLINE_END_BLOCK_CENTER`.
`control-inline-end-block-end`	تضع العنصر المُسنَد في الموضع `ControlPosition.INLINE_END_BLOCK_END`.
`control-inline-end-block-start`	تضع العنصر المُسنَد في الموضع `ControlPosition.INLINE_END_BLOCK_START`.
`control-inline-start-block-center`	تضع العنصر المُسنَد في الموضع `ControlPosition.INLINE_START_BLOCK_CENTER`.
`control-inline-start-block-end`	تضع العنصر المُسنَد في الموضع `ControlPosition.INLINE_START_BLOCK_END`.
`control-inline-start-block-start`	تضع العنصر المُسنَد في الموضع `ControlPosition.INLINE_START_BLOCK_START`.
`default`	يمكنك إنشاء مكوّنات قابلة لإعادة الاستخدام حول مكوّنات الويب JavaScript في "خرائط Google"، مثل `AdvancedMarkerElement`، باستخدام عناصر مخصّصة. وسيتم تلقائيًا إدراج أي عناصر مخصّصة تمت إضافتها مباشرةً إلى `MapElement` وعرضها في `MapPanes.overlayMouseTarget`. ومع ذلك، يمكن إعادة تخصيص مكونات Web لـ Maps JavaScript API إلى الفتحات الداخلية في `MapElement`.

الطُرق
`addEventListener`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `addEventListener(type, listener[, options])` المَعلمات: `type`: `string` سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه. `listener`: `EventListener\|EventListenerObject` العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent. `options`: `boolean\|AddEventListenerOptions optional` اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى `capture` و`passive`. القيمة المعروضة: `void` تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
`removeEventListener`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `removeEventListener(type, listener[, options])` المَعلمات: `type`: `string` سلسلة تحدّد نوع الحدث الذي يجب إزالة مستمع الحدث له. `listener`: `EventListener\|EventListenerObject` أداة معالجة الحدث المطلوب إزالتها من هدف الحدث `options`: `boolean\|EventListenerOptions optional` اطّلِع على الخيارات. القيمة المعروضة: `void` تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener.

الطُرق

addEventListener

addEventListener(type, listener[, options])

المَعلمات:

type: string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه.
listener: EventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent.
options: boolean|AddEventListenerOptions optional اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.

القيمة المعروضة: void

تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.

removeEventListener

removeEventListener(type, listener[, options])

المَعلمات:

type: string سلسلة تحدّد نوع الحدث الذي يجب إزالة مستمع الحدث له.
listener: EventListener|EventListenerObject أداة معالجة الحدث المطلوب إزالتها من هدف الحدث
options: boolean|EventListenerOptions optional اطّلِع على الخيارات.

القيمة المعروضة: void

تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener.

الفعاليات
`gmp-zoomchange`	`function(event)` الوسيطات: `event`: `ZoomChangeEvent` يتمّ تشغيل هذا الحدث عند تغيير خاصيّة تكبير/تصغير الخريطة.

واجهة MapElementOptions

google.maps.MapElementOptions واجهة

عنصر MapElementOptions المستخدَم لتحديد السمات التي يمكن ضبطها على MapElement

الخصائص
`center optional`	النوع: `LatLng\|LatLngLiteral optional` يمكنك الاطّلاع على `MapElement.center`.
`headingInteractionDisabled optional`	النوع: `boolean optional` يمكنك الاطّلاع على `MapElement.headingInteractionDisabled`.
`internalUsageAttributionIds optional`	النوع: `Iterable<string> optional` يمكنك الاطّلاع على `MapElement.internalUsageAttributionIds`.
`mapId optional`	النوع: `string optional` يمكنك الاطّلاع على `MapElement.mapId`.
`renderingType optional`	النوع: `RenderingType optional` يمكنك الاطّلاع على `MapElement.renderingType`.
`tiltInteractionDisabled optional`	النوع: `boolean optional` يمكنك الاطّلاع على `MapElement.tiltInteractionDisabled`.
`zoom optional`	النوع: `number optional` يمكنك الاطّلاع على `MapElement.zoom`.

ZoomChangeEvent class

google.maps.ZoomChangeEvent class

يتم إنشاء هذا الحدث من خلال رصد تغيير مستوى التكبير/التصغير.

يمتدّ هذا الصف إلى Event.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {ZoomChangeEvent} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

واجهة MapTypeStyle

google.maps.MapTypeStyle واجهة

MapTypeStyle هي مجموعة من أدوات الاختيار وأدوات وضع الأسلوب التي تحدّد كيفية وضع أسلوب على الخريطة. تحدِّد أدوات الاختيار ميزات و/أو عناصر الخريطة التي يجب أن تتأثر، وتحدِّد أدوات التنميط كيفية تعديل هذه الميزات والعناصر. لمعرفة التفاصيل، يُرجى الاطّلاع على مرجع الأنماط.

الخصائص
`stylers`	النوع: `Array<Object>` قواعد الأنماط التي سيتم تطبيقها على ميزات الخريطة وعناصرها المحدّدة يتم تطبيق القواعد بالترتيب الذي تحدّده في هذه الصفيف. للحصول على إرشادات حول الاستخدام والقيم المسموح بها، يُرجى الاطّلاع على مرجع الأنماط.
`elementType optional`	النوع: `string optional` العنصر الذي يجب تطبيق أداة تنسيق عليه. العنصر هو جانب مرئي لعنصر على الخريطة. مثال: تصنيف أو رمز أو حدّ أو تعبئة تم تطبيقها على الشكل الهندسي وغير ذلك. اختيارية: إذا لم يتم تحديد سمة `elementType`، يُفترض أنّ القيمة هي `'all'`. لمعرفة تفاصيل الاستخدام والقيم المسموح بها، يُرجى الاطّلاع على مرجع الأنماط.
`featureType optional`	النوع: `string optional` العنصر أو مجموعة العناصر التي يجب تطبيق أداة تنسيق عليها. اختيارية: إذا لم يتم تحديد سمة `featureType`، يُفترض أنّ القيمة هي `'all'`. لمعرفة تفاصيل الاستخدام والقيم المسموح بها، يُرجى الاطّلاع على مرجع الأنماط.

واجهة MapMouseEvent

google.maps.MapMouseEvent واجهة

يتم عرض هذا العنصر من أحداث الماوس المختلفة على الخريطة والعناصر التي تظهر فوقها، ويحتوي على جميع الحقول الموضّحة أدناه.

الخصائص
`domEvent`	النوع: `MouseEvent\|TouchEvent\|PointerEvent\|KeyboardEvent\|Event` حدث DOM الأصلي المقابل. يجب ألا يعتمد المطوّرون على سمات `target` و`currentTarget` و`relatedTarget` و`path` المحدّدة والمتسقة. يجب ألّا يعتمد المطوّرون أيضًا على بنية DOM لتنفيذ Google Maps API الداخلي. بسبب تعيين الأحداث الداخلية، قد يكون للعنصر `domEvent` دلالة مختلفة عن العنصر `MapMouseEvent` (على سبيل المثال، قد يكون للعنصر `MapMouseEvent` "النقر" `domEvent` من النوع `KeyboardEvent`).
`latLng optional`	النوع: `LatLng optional` خط العرض/خط الطول اللذان كانا أسفل المؤشر عند وقوع الحدث

الخصائص

domEvent

النوع: MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event

حدث DOM الأصلي المقابل. يجب ألا يعتمد المطوّرون على سمات target وcurrentTarget وrelatedTarget وpath المحدّدة والمتسقة. يجب ألّا يعتمد المطوّرون أيضًا على بنية DOM لتنفيذ Google Maps API الداخلي. بسبب تعيين الأحداث الداخلية، قد يكون للعنصر domEvent دلالة مختلفة عن العنصر MapMouseEvent (على سبيل المثال، قد يكون للعنصر MapMouseEvent "النقر" domEvent من النوع KeyboardEvent).

latLng optional

النوع: LatLng optional

خط العرض/خط الطول اللذان كانا أسفل المؤشر عند وقوع الحدث

الطُرق
`stop`	`stop()` المَعلمات: بدون القيمة المعروضة: `void` يمنع هذا الحدث من الانتشار أكثر.

واجهة IconMouseEvent

google.maps.IconMouseEvent واجهة

يتم إرسال هذا العنصر في حدث عندما ينقر أحد المستخدِمين على رمز على الخريطة. يتم تخزين معرّف المكان لهذا المكان في العنصر placeId. لمنع ظهور نافذة المعلومات التلقائية، يمكنك استدعاء طريقة stop() في هذا الحدث لمنع نشره. اطّلِع على مزيد من المعلومات حول أرقام تعريف الأماكن في دليل مطوّري واجهة برمجة التطبيقات Places API.

تمتد هذه الواجهة MapMouseEvent.

الخصائص
`placeId optional`	النوع: `string optional` معرّف المكان الذي تم النقر عليه. يمكن استخدام معرّف المكان هذا لطلب المزيد من المعلومات عن العنصر الذي تم النقر عليه. اطّلِع على مزيد من المعلومات حول أرقام تعريف الأماكن في دليل مطوّري واجهة برمجة التطبيقات Places API.
مكتسَبة: `domEvent`، `latLng`

الخصائص

placeId optional

النوع: string optional

معرّف المكان الذي تم النقر عليه. يمكن استخدام معرّف المكان هذا لطلب المزيد من المعلومات عن العنصر الذي تم النقر عليه.

اطّلِع على مزيد من المعلومات حول أرقام تعريف الأماكن في دليل مطوّري واجهة برمجة التطبيقات Places API.

مكتسَبة: domEvent، latLng

الطُرق
مكتسَبة: `stop`

ColorScheme الثوابت

google.maps.ColorScheme الثوابت

معرّفات أنظمة ألوان الخرائط حدِّد هذه العناصر حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'FOLLOW_SYSTEM' أو google.maps.ColorScheme.FOLLOW_SYSTEM.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {ColorScheme} = await google.maps.importLibrary("core"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
`DARK`	الألوان الداكنة في الخريطة
`FOLLOW_SYSTEM`	يتم اختيار نظام الألوان استنادًا إلى الإعدادات المفضّلة للنظام.
`LIGHT`	نظام الألوان الفاتح للخريطة القيمة التلقائية لـ "خرائط Google" JavaScript القديمة

MapTypeId الثوابت

google.maps.MapTypeId الثوابت

معرّفات لأنواع الخرائط الشائعة حدِّد هذه العناصر حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'satellite' أو google.maps.MapTypeId.SATELLITE.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {MapTypeId} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
`HYBRID`	يعرض هذا النوع من الخرائط طبقة شفافة للشوارع الرئيسية على صور الأقمار الصناعية.
`ROADMAP`	يعرض هذا النوع من الخرائط خريطة شوارع عادية.
`SATELLITE`	يعرض هذا النوع من الخرائط صور الأقمار الصناعية.
`TERRAIN`	يعرض هذا النوع من الخرائط خرائط تتضمّن عناصر جغرافية، مثل التضاريس والنباتات.

فئة MapTypeRegistry

google.maps.MapTypeRegistry class

قاعدة بيانات مسجّلين لكائنات MapType، يتمّ ترتيبها حسب رقم تعريف MapType.

يمتدّ هذا الصف إلى MVCObject.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {MapTypeRegistry} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`MapTypeRegistry`	`MapTypeRegistry()` المَعلمات: بدون يحتوي العنصر `MapTypeRegistry` على مجموعة أنواع الخرائط المخصّصة المتاحة للخريطة لاستخدامها. ترجع واجهة برمجة التطبيقات إلى هذا السجلّ عند تقديم قائمة بأنواع الخرائط المتاحة ضمن عناصر التحكّم، على سبيل المثال.

الشركة المصنِّعة

MapTypeRegistry

MapTypeRegistry()

المَعلمات: بدون

يحتوي العنصر MapTypeRegistry على مجموعة أنواع الخرائط المخصّصة المتاحة للخريطة لاستخدامها. ترجع واجهة برمجة التطبيقات إلى هذا السجلّ عند تقديم قائمة بأنواع الخرائط المتاحة ضمن عناصر التحكّم، على سبيل المثال.

الطُرق
`set`	`set(id, mapType)` المَعلمات: ‫`id`: `string` معرّف MapType المطلوب إضافته إلى السجلّ ‫`mapType`: `MapType\|?` عنصر MapType لإضافته إلى السجلّ القيمة المعروضة: لا شيء تضبط السجلّ لربط معرّف السلسلة الذي تم تمريره بنوع الخريطة الذي تم تمريره.
مُكتسَبة: `addListener`، `bindTo`، `get`، `notify`، `setValues`، `unbind`، `unbindAll`

واجهة MapRestriction

google.maps.MapRestriction واجهة

قيد يمكن تطبيقه على الخريطة ولن تتجاوز مساحة العرض في الخريطة هذه القيود.

الخصائص
`latLngBounds`	النوع: `LatLngBounds\|LatLngBoundsLiteral` عند ضبطها، يمكن للمستخدم التمرير والتكبير/التصغير داخل الحدود المحدّدة فقط. يمكن أن تحد الحدود من خط الطول وخط العرض معًا، أو يمكن أن تحد من خط العرض فقط. بالنسبة إلى الحدود المتعلّقة بخط العرض فقط، استخدِم خطي الطول الغربي والشرقي -180 و180 على التوالي، على سبيل المثال، `latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}`.
`strictBounds optional`	النوع: `boolean optional` يمكن جعل الحدود أكثر تقييدًا من خلال ضبط العلامة `strictBounds` على `true`. يقلل ذلك من مدى تكبير المستخدم للخريطة، ما يضمن إخفاء كل المحتوى خارج الحدود المحظورة. القيمة التلقائية هي `false`، ما يعني أنّه يمكن للمستخدم تصغير الصورة إلى أن تظهر المنطقة المحدودة بالكامل، بما في ذلك المناطق خارج المنطقة المحدودة.

الخصائص

latLngBounds

النوع: LatLngBounds|LatLngBoundsLiteral

عند ضبطها، يمكن للمستخدم التمرير والتكبير/التصغير داخل الحدود المحدّدة فقط. يمكن أن تحد الحدود من خط الطول وخط العرض معًا، أو يمكن أن تحد من خط العرض فقط. بالنسبة إلى الحدود المتعلّقة بخط العرض فقط، استخدِم خطي الطول الغربي والشرقي -180 و180 على التوالي، على سبيل المثال، latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.

strictBounds optional

النوع: boolean optional

يمكن جعل الحدود أكثر تقييدًا من خلال ضبط العلامة strictBounds على true. يقلل ذلك من مدى تكبير المستخدم للخريطة، ما يضمن إخفاء كل المحتوى خارج الحدود المحظورة. القيمة التلقائية هي false، ما يعني أنّه يمكن للمستخدم تصغير الصورة إلى أن تظهر المنطقة المحدودة بالكامل، بما في ذلك المناطق خارج المنطقة المحدودة.

فئة TrafficLayer

google.maps.TrafficLayer class

طبقة كثافة حركة المرور

يمتدّ هذا الصف إلى MVCObject.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {TrafficLayer} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`TrafficLayer`	`TrafficLayer([opts])` المَعلمات: `opts`: `TrafficLayerOptions optional` طبقة تعرض حركة المرور الحالية على الطرق

الطُرق
`getMap`	`getMap()` المَعلمات: بدون القيمة المعروضة: `Map\|null` تعرِض الخريطة التي يتم عرض هذه الطبقة عليها.
`setMap`	`setMap(map)` المَعلمات: `map`: `Map optional` القيمة المعروضة: لا شيء لعرض الطبقة على الخريطة المحدّدة إذا تم ضبط الخريطة على `null`، ستتم إزالة الطبقة.
`setOptions`	`setOptions(options)` المَعلمات: `options`: `TrafficLayerOptions optional` القيمة المعروضة: لا شيء
مُكتسَبة: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

واجهة TrafficLayerOptions

google.maps.TrafficLayerOptions واجهة

عنصر TrafficLayerOptions المستخدَم لتحديد السمات التي يمكن ضبطها على TrafficLayer

الخصائص
`autoRefresh optional`	النوع: `boolean optional` القيمة التلقائية: `true` ما إذا كانت طبقة حركة المرور تتم إعادة تحميلها تلقائيًا باستخدام المعلومات المعدَّلة
`map optional`	النوع: `Map optional` الخريطة التي سيتم عرض طبقة حركة المرور عليها

فئة TransitLayer

google.maps.TransitLayer class

طبقة النقل العام

يمتدّ هذا الصف إلى MVCObject.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {TransitLayer} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`TransitLayer`	`TransitLayer()` المَعلمات: بدون طبقة تعرض خطوط النقل العام

الطُرق
`getMap`	`getMap()` المَعلمات: بدون القيمة المعروضة: `Map\|null` تعرِض الخريطة التي يتم عرض هذه الطبقة عليها.
`setMap`	`setMap(map)` المَعلمات: `map`: `Map optional` القيمة المعروضة: `void` لعرض الطبقة على الخريطة المحدّدة إذا تم ضبط الخريطة على `null`، ستتم إزالة الطبقة.
مُكتسَبة: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

فئة BicyclingLayer

google.maps.BicyclingLayer class

طبقة تعرض مسارات الدراجات

يمتدّ هذا الصف إلى MVCObject.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {BicyclingLayer} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`BicyclingLayer`	`BicyclingLayer()` المَعلمات: بدون طبقة تعرض مسارات الدراجات وتُخفض ترتيب الطرق الكبيرة

الطُرق
`getMap`	`getMap()` المَعلمات: بدون القيمة المعروضة: `Map\|null` تعرِض الخريطة التي يتم عرض هذه الطبقة عليها.
`setMap`	`setMap(map)` المَعلمات: `map`: `Map optional` القيمة المعروضة: `void` لعرض الطبقة على الخريطة المحدّدة إذا تم ضبط الخريطة على `null`، ستتم إزالة الطبقة.
مُكتسَبة: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

واجهة CameraOptions

google.maps.CameraOptions واجهة

تُستخدَم لضبط خيارات الكاميرا في الخريطة.

الخصائص
`center optional`	النوع: `LatLngLiteral\|LatLng optional`
`heading optional`	النوع: `number optional`
`tilt optional`	النوع: `number optional`
`zoom optional`	النوع: `number optional`

واجهة VisibleRegion

google.maps.VisibleRegion واجهة

يحتوي على النقاط الأربع التي تحدّد المضلّع الرباعي الذي يمثّل المنطقة المرئية من الخريطة. في الخريطة الاتجاهية، يمكن أن يكون هذا المضلّع شبه منحرف بدلاً من مستطيل، عندما تكون الخريطة الاتجاهية مائلة.

الخصائص
`farLeft`	النوع: `LatLng`
`farRight`	النوع: `LatLng`
`latLngBounds`	النوع: `LatLngBounds` أصغر مربّع حدود يتضمّن المنطقة المرئية.
`nearLeft`	النوع: `LatLng`
`nearRight`	النوع: `LatLng`

RenderingType الثوابت

google.maps.RenderingType الثوابت

يمكنك الوصول إليه من خلال الاتصال بالرقم const {RenderingType} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
`RASTER`	يشير إلى أنّ الخريطة هي خريطة نقطية.
`UNINITIALIZED`	يشير ذلك إلى أنّه لا يُعرف بعد ما إذا كانت الخريطة متجهّة أو ذا شبكة خطوط، لأنّه لم تكتمل عملية إعداد الخريطة بعد.
`VECTOR`	تشير إلى أنّ الخريطة هي خريطة اتجاهية.

واجهة MapCapabilities

google.maps.MapCapabilities واجهة

عنصر يحتوي على لقطة لإمكانيات الخريطة المتاحة حاليًا يُرجى العلم أنّ هذا لا يعني بالضرورة أنّه تم تحميل الوحدات ذات الصلة أو بدء تشغيلها، بل يعني أنّ الخريطة الحالية لديها إذن لاستخدام واجهات برمجة التطبيقات هذه. اطّلِع على السمات للحصول على قائمة بالإمكانات المحتمَلة.

الخصائص
`isAdvancedMarkersAvailable optional`	النوع: `boolean optional` إذا كان صحيحًا، تم ضبط هذه الخريطة بشكل صحيح للسماح باستخدام علامات متقدّمة. يُرجى العِلم أنّه لا يزال عليك استيراد مكتبة `marker` لاستخدام العلامات المتقدّمة. يُرجى الانتقال إلى https://goo.gle/gmp-isAdvancedMarkersAvailable للحصول على مزيد من المعلومات.
`isDataDrivenStylingAvailable optional`	النوع: `boolean optional` إذا كان صحيحًا، تم ضبط هذه الخريطة بشكل صحيح للسماح باستخدام التنسيق المستنِد إلى البيانات لطبقة ميزة واحدة على الأقل. يُرجى الاطّلاع على https://goo.gle/gmp-data-driven-styling وhttps://goo.gle/gmp-FeatureLayerIsAvailable للحصول على مزيد من المعلومات.
`isWebGLOverlayViewAvailable optional`	النوع: `boolean optional` إذا كان صحيحًا، تم ضبط هذه الخريطة بشكل صحيح للسماح باستخدام `WebGLOverlayView`.

Maps

فئة الخريطة

الشركة المصنِّعة

الثوابت

الخصائص

الطُرق

الفعاليات

واجهة MapOptions

الخصائص

فئة MapElement

الشركة المصنِّعة

الخصائص

الماكينات الشقبية

الطُرق

الفعاليات

واجهة MapElementOptions

الخصائص

ZoomChangeEvent class

واجهة MapTypeStyle

الخصائص

واجهة MapMouseEvent

الخصائص

الطُرق

واجهة IconMouseEvent

الخصائص

الطُرق

ColorScheme الثوابت

الثوابت

MapTypeId الثوابت

الثوابت

فئة MapTypeRegistry

الشركة المصنِّعة

الطُرق

واجهة MapRestriction

الخصائص

فئة TrafficLayer

الشركة المصنِّعة

الطُرق

واجهة TrafficLayerOptions

الخصائص

فئة TransitLayer

الشركة المصنِّعة

الطُرق

فئة BicyclingLayer

الشركة المصنِّعة

الطُرق

واجهة CameraOptions

الخصائص

واجهة VisibleRegion

الخصائص

RenderingType الثوابت

الثوابت

واجهة MapCapabilities

الخصائص