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

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

Maps

فئة الخريطة

google.maps.Map class

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

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

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

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

الثوابت

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

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

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

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

واجهة MapOptions

google.maps.MapOptions واجهة

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

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

فئة MapElement

google.maps.MapElement class

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

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

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

العنصر المخصّص:
<gmp-map center="lat,lng" heading-interaction-disabled 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 في "خرائط Google"، مثل `AdvancedMarkerElement`، باستخدام عناصر مخصّصة. بشكل تلقائي، سيتم وضع أي عناصر مخصّصة تتم إضافتها مباشرةً إلى `MapElement` وعرضها في `MapPanes.overlayMouseTarget`. ومع ذلك، يمكن إعادة تخصيص مكونات Web لـ Maps JavaScript API إلى الفتحات الداخلية في `MapElement`.

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

الطُرق

addEventListener

addEventListener(type, listener[, options])

المَعلمات:

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

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

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

removeEventListener

removeEventListener(type, listener[, options])

المَعلمات:

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

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

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

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

واجهة MapElementOptions

google.maps.MapElementOptions واجهة

يتم استخدام كائن MapElementOptions لتحديد الخصائص التي يمكن تعيينها على MapElement.

أماكن إقامة
`center optional`	النوع: `LatLng\|LatLngLiteral optional` يمكنك الاطّلاع على `MapElement.center`.
`headingInteractionDisabled optional`	النوع: `boolean optional` يمكنك الاطّلاع على `MapElement.headingInteractionDisabled`.
`mapId optional`	النوع: `string optional` يمكنك الاطّلاع على `MapElement.mapId`.
`renderingType optional`	النوع: `RenderingType optional` يمكنك الاطّلاع على `MapElement.renderingType`.
`tiltInteractionDisabled optional`	النوع: `boolean optional` يمكنك الاطّلاع على `MapElement.tiltInteractionDisabled`.
`zoom optional`	النوع: `number optional` يمكنك الاطّلاع على `MapElement.zoom`.

ZoomChangeEvent class

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

تم إنشاء هذا الحدث من مراقبة تغيير التكبير أو التصغير.

يمتدّ هذا الصف 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 واجهة

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

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

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

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

ColorScheme الثوابت

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

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

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

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

MapTypeId الثوابت

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

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

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

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

فئة MapTypeRegistry

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

سجلّ لمثيلات MapType، مُقسَّم بواسطة معرّف MapType.

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

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

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

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

MapTypeRegistry

MapTypeRegistry()

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

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

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

واجهة MapRestriction

google.maps.MapRestriction واجهة

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

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

أماكن إقامة

latLngBounds

النوع: LatLngBounds|LatLngBoundsLiteral

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

strictBounds optional

النوع: boolean optional

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

فئة TrafficLayer

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

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

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

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

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

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

واجهة TrafficLayerOptions

google.maps.TrafficLayerOptions واجهة

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

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

فئة TransitLayer

google.maps.TransitLayer class

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

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

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

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

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

BicyclingLayer

google.maps.BicyclingLayer class

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

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

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

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

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

واجهة CameraOptions

google.maps.CameraOptions واجهة

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

أماكن إقامة
`center optional`	النوع: `LatLngLiteral\|LatLng optional`
`heading optional`	النوع: `number optional`
`tilt optional`	النوع: `number optional`
`zoom optional`	النوع: `number optional`

واجهة VisibleRegion

واجهة google.maps.VisibleRegion

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

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

RenderingType الثوابت

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

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

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

واجهة MapCapabilities

google.maps.MapCapabilities واجهة

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

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

Maps

فئة الخريطة

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

الثوابت

أماكن إقامة

الطُرق

الفعاليات

واجهة MapOptions

أماكن إقامة

فئة MapElement

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

أماكن إقامة

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

الطُرق

الفعاليات

واجهة MapElementOptions

أماكن إقامة

ZoomChangeEvent class

واجهة MapTypeStyle

أماكن إقامة

واجهة MapMouseEvent

أماكن إقامة

الطُرق

واجهة IconMouseEvent

أماكن إقامة

الطُرق

ColorScheme الثوابت

الثوابت

MapTypeId الثوابت

الثوابت

فئة MapTypeRegistry

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

الطُرق

واجهة MapRestriction

أماكن إقامة

فئة TrafficLayer

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

الطُرق

واجهة TrafficLayerOptions

أماكن إقامة

فئة TransitLayer

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

الطُرق

BicyclingLayer

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

الطُرق

واجهة CameraOptions

أماكن إقامة

واجهة VisibleRegion

أماكن إقامة

RenderingType الثوابت

الثوابت

واجهة MapCapabilities

أماكن إقامة