إشعار الأمان: نما إلى علمنا بمشكلة أمنية قد تؤثر في المواقع الإلكترونية التي تستخدم مكتبات معيّنة تابعة لجهات خارجية (بما في ذلك polyfill.io). وقد تؤدي هذه المشكلة في بعض الأحيان إلى إعادة توجيه الزائرين بعيدًا عن الموقع الإلكتروني المقصود بدون معرفة مالك الموقع أو إذنه. وفي السابق، كان يتضمّن العديد من نماذج JavaScript تعريف النص البرمجي polyfill.io. تمت إزالة هذا المحتوى من نماذجنا. إذا كنت قد استخدمت نماذج JavaScript التي تحتوي على هذا التعريف، ننصحك بإزالة التعريف.

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

Maps

فئة الخريطة

صف واحد (google.maps.Map)

تمتد هذه الفئة إلى MVCObject.

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

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

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

الثوابت

DEMO_MAP_ID رقم تعريف الخريطة الذي يمكن استخدامه لعيّنات التعليمات البرمجية التي تتطلّب رقم تعريف خريطة إنّ رقم تعريف الخريطة هذا غير مخصَّص للاستخدام في تطبيقات الإنتاج، ولا يمكن استخدامه في الميزات التي تتطلّب إعداد السحابة الإلكترونية (مثل التصميم على السحابة الإلكترونية).

أماكن إقامة
`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 channel. `getDatasetFeatureLayer(datasetId)` المَعلمات: `datasetId`: `string` قيمة الإرجاع: `FeatureLayer` لعرض `FeatureLayer` للسمة `datasetId` المحدّدة. يجب إعداد أرقام تعريف مجموعات البيانات في Google Cloud Console. إذا لم يكن معرّف مجموعة البيانات مرتبطًا بنمط الخريطة للخريطة، أو إذا كان النمط المستند إلى البيانات غير متاح (لا يوجد معرّف خريطة أو بلا مربعات متجهات أو طبقات عناصر تصميم يستند إلى البيانات أو مجموعات بيانات تم ضبطها في نمط الخريطة)، فإن هذا يسجل خطأ، وسيكون `FeatureLayer.isAvailable` الناتج خطأ.
`getDiv`	`getDiv()` المَعلمات: لا شيء قيمة الإرجاع: `HTMLElement` عنصر خريطة الخريطة.
`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` يعرض ما إذا كانت تفاعلات العناوين مفعّلة. لا يكون هذا الخيار ساري المفعول إلا عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط الرمز في رمز، سيتم استخدام إعدادات السحابة الإلكترونية لمعرّف الخريطة (إذا كان ذلك متاحًا).
`getMapCapabilities`	`getMapCapabilities()` المَعلمات: لا شيء قيمة الإرجاع: `MapCapabilities` إبلاغ المتصل بالإمكانات الحالية المتاحة على الخريطة بناءً على معرّف الخريطة الذي تم تقديمه.
`getMapTypeId`	`getMapTypeId()` المَعلمات: لا شيء قيمة الإرجاع: `MapTypeId\|string\|undefined`
`getProjection`	`getProjection()` المَعلمات: لا شيء قيمة الإرجاع: `Projection\|undefined` تعرض قيمة `Projection` الحالية. إذا لم يتم إعداد الخريطة إلى الآن، تكون النتيجة `undefined`. يُرجى الاستماع إلى حدث "`projection_changed`" والتحقّق من قيمته للتأكّد من أنّه ليس حدث "`undefined`".
`getRenderingType`	`getRenderingType()` المَعلمات: لا شيء قيمة الإرجاع: `RenderingType` لعرض 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)` إلى استخدام الخريطة دائمًا للعرض من الأعلى إلى الأعلى بغض النظر عن مستوى التكبير أو التصغير وإطار العرض. يؤدّي `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 AuthenticationList على حاوية الخريطة.
`dblclick`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عندما ينقر المستخدِم مرّتين على الخريطة. تجدر الإشارة إلى أنّه سيتم تنشيط حدث النقر مرّة واحدة وأحيانًا مرّتين، قبل هذا الحدث مباشرةً.
`drag`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث بشكلٍ متكرر أثناء سحب المستخدم للخريطة.
`dragend`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب الخريطة.
`dragstart`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب الخريطة.
`heading_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير خاصية عنوان الخريطة.
`idle`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما تصبح الخريطة في وضع عدم النشاط بعد العرض الشامل أو التكبير/التصغير.
`isfractionalzoomenabled_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير الخاصية isFracationsZoomEnabled.
`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()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير arrangeType.
`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` اللون المستخدم لخلفية قسم الخريطة. سيكون هذا اللون مرئيًا عندما لا يتم تحميل الفئات حتى الآن أثناء تحرك المستخدم. لا يمكن ضبط هذا الخيار إلا عندما يتم إعداد الخريطة.
`center optional`	النوع: `LatLng\|LatLngLiteral optional` تمثّل هذه السمة مركز الخريطة الأولي.
`clickableIcons optional`	النوع: `boolean optional` الخيار التلقائي: `true` عند عرض `false`، لا تكون رموز الخرائط قابلة للنقر. يمثل رمز الخريطة نقطة اهتمام، وتُعرف أيضًا باسم نقطة الاهتمام.
`controlSize optional`	النوع: `number optional` الحجم بالبكسل لعناصر التحكم التي تظهر على الخريطة. يجب تقديم هذه القيمة مباشرةً عند إنشاء الخريطة، وقد يؤدي تعديلها في وقت لاحق إلى تغيير عناصر التحكّم إلى حالة `undefined`. يتحكّم فقط في عناصر التحكّم التي توفّرها واجهة برمجة تطبيقات الخرائط نفسها. لا يؤدي إلى توسيع نطاق عناصر التحكّم المخصّصة التي أنشأها المطوّر.
`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 للمؤشر الذي سيتم عرضه عند تمرير الماوس فوق خريطة قابلة للسحب. تستخدم هذه السمة سمة css `cursor` لتغيير الرمز. كما هي الحال مع سمة css، يجب تحديد مؤشر احتياطي واحد على الأقل ليس عنوان URL. مثلاً: `draggableCursor: 'url(http://www.example.com/icon.png), auto;'`
`draggingCursor optional`	النوع: `string optional` اسم أو عنوان URL للمؤشر الذي سيتم عرضه عند سحب الخريطة. تستخدم هذه السمة سمة css `cursor` لتغيير الرمز. كما هي الحال مع سمة 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` ما إذا كان يجب أن تسمح الخريطة للمستخدم بالتحكّم في عنوان الكاميرا (التدوير) لا يكون هذا الخيار ساري المفعول إلا عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط الرمز في رمز، سيتم استخدام إعدادات السحابة الإلكترونية لمعرّف الخريطة (إذا كان ذلك متاحًا).
`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`، يُرجى عدم محو محتوى قسم "الخريطة".
`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` إلى استخدام الخريطة دائمًا للعرض العلوي بغض النظر عن مستوى التكبير/التصغير وإطار العرض. تؤدي القيمة `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)

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 map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

تمتد هذه الفئة إلى HTMLElement.

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

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

الشركة المصنِّعة
`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 داخليًا.
`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`. ومع ذلك، قد تتم إعادة تقسيم مكونات الويب لواجهة برمجة تطبيقات JavaScript لـ "خرائط Google" إلى الخانات الداخلية في `MapElement`.

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

صف واحد (google.maps.ZoomChangeEvent)

يتم إنشاء هذا الحدث من رصد التغيُّر في مستوى التكبير أو التصغير.

تمتد هذه الفئة إلى Event.

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

الواجهة 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 للتنفيذ الداخلي لواجهة برمجة تطبيقات الخرائط. بسبب ربط الأحداث الداخلية، قد تختلف دلالات `domEvent` عن `MapMouseEvent` (على سبيل المثال، قد يكون لـ `MapMouseEvent` "نقرة" نوع `domEvent` `KeyboardEvent`).
`latLng optional`	النوع: `LatLng optional` خط العرض/خط الطول الذي كان أسفل المؤشر عند وقوع الحدث.

أماكن إقامة

domEvent

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

حدث DOM الأصلي المقابل يجب ألّا يعتمد المطوّرون على السمات target وcurrentTarget وrelatedTarget وpath المحدّدة والمتسقة. يجب ألا يعتمد المطوّرون أيضًا على بنية DOM للتنفيذ الداخلي لواجهة برمجة تطبيقات الخرائط. بسبب ربط الأحداث الداخلية، قد تختلف دلالات 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`

الثوابت MapTypeId

google.maps.MapTypeId ثابت

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

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

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

فئة MapTypeRegistry

صف واحد (google.maps.MapTypeRegistry)

سجلّ لمثيلات MapType، مفتاحًا بمعرّف MapType.

تمتد هذه الفئة إلى MVCObject.

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

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

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

MapTypeRegistry

MapTypeRegistry()

المَعلمات: لا شيء

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

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

الطُرق

set

set(id, mapType)

المَعلمات:

id: string معرّف MapType المطلوب إضافته إلى السجلّ.
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)

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

تمتد هذه الفئة إلى MVCObject.

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

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

الطُرق
`getMap`	`getMap()` المَعلمات: لا شيء قيمة الإرجاع: `Map` لعرض الخريطة التي يتم عرض هذه الطبقة عليها.
`setMap`	`setMap(map)` المَعلمات: `map`: `Map` قيمة الإرجاع: لا شيء يعرض الطبقة على الخريطة المحددة. في حال ضبط الخريطة على `null`، ستتم إزالة الطبقة.
`setOptions`	`setOptions(options)` المَعلمات: `options`: `TrafficLayerOptions` قيمة الإرجاع: لا شيء
المحتوى المُكتسَب: `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)

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

تمتد هذه الفئة إلى MVCObject.

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

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

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

فئة BicyclingLayer

صف واحد (google.maps.BicyclingLayer)

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

تمتد هذه الفئة إلى MVCObject.

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

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

الطُرق
`getMap`	`getMap()` المَعلمات: لا شيء قيمة الإرجاع: `Map` لعرض الخريطة التي يتم عرض هذه الطبقة عليها.
`setMap`	`setMap(map)` المَعلمات: `map`: `Map` قيمة الإرجاع: لا شيء يعرض الطبقة على الخريطة المحددة. في حال ضبط الخريطة على `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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

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

واجهة MapCapabilities

واجهة google.maps.MapCapabilities

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

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

Maps

فئة الخريطة

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

الثوابت

أماكن إقامة

الطُرق

فعاليات

واجهة MapOptions

أماكن إقامة

فئة MapElement

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

أماكن إقامة

ألعاب المقامرة

الطُرق

فعاليات

واجهة MapElementOptions

أماكن إقامة

فئة ZoomChangeEvent

الواجهة MapTypeStyle

أماكن إقامة

واجهة MapMouseEvent

أماكن إقامة

الطُرق

واجهة IconMouseEvent

أماكن إقامة

الطُرق

الثوابت MapTypeId

الثوابت

فئة MapTypeRegistry

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

الطُرق

واجهة MapRestriction

أماكن إقامة

فئة TrafficLayer

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

الطُرق

واجهة TrafficLayerOptions

أماكن إقامة

فئة TransitLayer

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

الطُرق

فئة BicyclingLayer

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

الطُرق

واجهة CameraOptions

أماكن إقامة

واجهة VisibleRegion

أماكن إقامة

القيم الثابتة RenderingType

الثوابت

واجهة MapCapabilities

أماكن إقامة