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

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

Maps

خريطة الصنف

google.maps.Map الصنف

هذه الفئة تمتد MVCObject

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

الشركة المصنِّعة
`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. `getDatasetFeatureLayer(datasetId)` المَعلمات: `datasetId`: `string` القيمة المعروضة: `FeatureLayer` لعرض `FeatureLayer` لسمة `datasetId` المحددة. يجب إعداد أرقام تعريف مجموعات البيانات في Google Cloud Console. إذا لم يكن معرِّف مجموعة البيانات مرتبطًا بنمط الخريطة، أو إذا كان النمط المستند إلى البيانات غير متاح (بدون معرّف خريطة أو مربّعات متجهات أو طبقات ميزة النمط المستند إلى البيانات أو مجموعات بيانات تم ضبطها في "نمط الخريطة")، سيتم تسجيل خطأ، وستكون قيمة `FeatureLayer.isAvailable` الناتجة false.
`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` تعرض ما إذا كانت تفاعلات العناوين مفعّلة. يسري هذا الخيار فقط عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط السياسة في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان ذلك متاحًا).
`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` عدد وحدات البكسل لتحريك الخريطة في الاتجاه ص. القيمة المعروضة: ما مِن قيمة لتغيير مركز الخريطة من خلال المسافة المحددة بالبكسل. وإذا كانت المسافة أقل من عرض الخريطة وارتفاعها، ستكون عملية الانتقال متحركًا بسلاسة. لاحظ أن نظام إحداثيات الخريطة يزيد من الغرب إلى الشرق (للقيم س) ومن الشمال إلى الجنوب (للقيم ص).
`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()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب الخريطة.
`dragstart`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب الخريطة.
`heading_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما تتغير خاصية عنوان الخريطة.
`idle`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما تصبح الخريطة غير نشطة بعد العرض الشامل أو التكبير/التصغير.
`isfractionalzoomenabled_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير السمة isFracatoryZoomEnabled.
`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()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير نوع العرض.
`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. سيظهر هذا اللون عندما لا يتم تحميل المربّعات بعد أن يتم عرضها للمستخدم. يمكن فقط ضبط هذا الخيار عند إعداد الخريطة.
`center optional`	النوع: `LatLng\|LatLngLiteral optional` مركز الخرائط الأولي.
`clickableIcons optional`	النوع: `boolean optional` تلقائي: `true` عندما `false`، لا تكون رموز الخريطة قابلة للنقر. يشير رمز الخريطة إلى نقطة اهتمام، تُعرف أيضًا باسم نقطة الاهتمام.
`colorScheme optional`	إشعار: متوفّر فقط في قناة v=beta. النوع: `ColorScheme\|string optional` تلقائي: `ColorScheme.LIGHT` نظام ألوان الخريطة الأولي. يمكن فقط ضبط هذا الخيار عند إعداد الخريطة.
`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 للمؤشر المراد عرضه عند تمرير الماوس فوق خريطة قابلة للسحب. تستخدم هذه السمة سمة `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` ما إذا كان يجب أن تسمح الخريطة للمستخدم بتحكُّم عنوان الكاميرا (التدوير) يسري هذا الخيار فقط عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط السياسة في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان ذلك متاحًا).
`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` وهذا الخيار يشيران إلى عدة عناصر، لا تستخدم السمة `tilt` `bind()`. القيام بذلك قد ينتج عنه تأثيرات غير متوقعة.
`tiltInteractionEnabled optional`	النوع: `boolean optional` تلقائي: `false` ما إذا كان يجب أن تسمح الخريطة للمستخدم بالتحكّم في إمالة الكاميرا يسري هذا الخيار فقط عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط السياسة في الرمز، سيتم استخدام إعدادات السحابة الإلكترونية لرقم تعريف الخريطة (إذا كان ذلك متاحًا).
`zoom optional`	النوع: `number optional` مستوى تكبير/تصغير الخريطة الأولي. قيم التكبير/التصغير الصالحة هي أرقام تتراوح من صفر إلى الحد الأقصى لمستوى التكبير المسموح به. تتوافق قيم التكبير/التصغير الأكبر مع الدقة الأعلى.
`zoomControl optional`	النوع: `boolean optional` حالة التفعيل أو الإيقاف لعنصر التحكّم في Zoom.
`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"). اطّلع على المكتبات في واجهة برمجة تطبيقات 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 داخليًا.
`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 للخرائط، مثل `AdvancedMarkerElement`، باستخدام عناصر مخصصة. بشكل تلقائي، سيتم وضع أي عناصر مخصّصة تتم إضافتها مباشرةً إلى `MapElement` وعرضها في `MapPanes.overlayMouseTarget`. ومع ذلك، قد تتم إعادة تقسيم مكونات الويب لواجهة برمجة تطبيقات JavaScript للخرائط إلى خانات `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`.
`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"). اطّلع على المكتبات في واجهة برمجة تطبيقات 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) للتطبيق الداخلي لواجهة برمجة تطبيقات الخرائط. بسبب ربط الحدث الداخلي، قد تختلف دلالات `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 واحدة

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

توسع هذه الواجهة MapMouseEvent

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

أماكن إقامة

placeId optional

النوع: string optional

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

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

مُكتسَب: domEvent, latLng

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

نظام الألوان الثوابت

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

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

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

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

MapTypeId الثوابت

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

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

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

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

MapTypeRegistry الصنف

google.maps.MapTypeRegistry الصنف

سجلّ لمثيلات 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 لإضافته إلى قاعدة بيانات المسجّلين القيمة المعروضة:* ما مِن قيمة تضبط هذه السياسة قاعدة بيانات المسجّلين لربط معرّف السلسلة الذي تم تمريره بالرمز 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"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`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"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`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"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`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"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

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

MapCapabilities واحدة

google.maps.MapCapabilities واحدة

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

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

Maps

خريطة الصنف

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

الثوابت

أماكن إقامة

الطُرق

فعاليات

MapOptions واحدة

أماكن إقامة

MapElement الصنف

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

أماكن إقامة

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

الطُرق

فعاليات

MapElementOptions واحدة

أماكن إقامة

ZoomChangeEvent الصنف

MapTypeStyle واحدة

أماكن إقامة

MapMouseEvent واحدة

أماكن إقامة

الطُرق

IconMouseEvent واحدة

أماكن إقامة

الطُرق

نظام الألوان الثوابت

الثوابت

MapTypeId الثوابت

الثوابت

MapTypeRegistry الصنف

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

الطُرق

MapRestriction واحدة

أماكن إقامة

TrafficLayer الصنف

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

الطُرق

TrafficLayerOptions واحدة

أماكن إقامة

TransitLayer الصنف

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

الطُرق

BicyclingLayer الصنف

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

الطُرق

CameraOptions واحدة

أماكن إقامة

VisibleRegion واحدة

أماكن إقامة

RenderingType الثوابت

الثوابت

MapCapabilities واحدة

أماكن إقامة