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

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

Maps

فئة الخريطة

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

تشمل هذه الفئة تجربة "MVCObject".

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

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

الثوابت
`DEMO_MAP_ID`	رقم تعريف الخريطة الذي يمكن استخدامه لعيّنات التعليمات البرمجية التي تتطلّب معرّف خريطة. رقم تعريف الخريطة هذا غير مخصَّص للاستخدام في تطبيقات الإنتاج، ولا يمكن استخدامه مع الميزات التي تتطلّب إعداد السحابة الإلكترونية (مثل 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`.
`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`.
`getZoom`	`getZoom()` المَعلمات: بدون قيمة العرض: `number\|undefined` لعرض تكبير الخريطة أو تصغيرها. في حال عدم ضبط مستوى التكبير/التصغير، تكون النتيجة `undefined`.
`moveCamera`	`moveCamera(cameraOptions)` المَعلمات: `cameraOptions`: `CameraOptions` القيمة المعروضة: لا شيء يضبط كاميرا الخريطة فورًا على خيارات الكاميرا المستهدفة، بدون رسوم متحركة.
`panBy`	`panBy(x, y)` المَعلمات: `x`: `number` عدد وحدات البكسل لتحريك الخريطة في الاتجاه x. `y`: `number` عدد وحدات البكسل لتحريك الخريطة في الاتجاه y. القيمة المعروضة: لا شيء لتغيير مركز الخريطة بالمسافة المحددة بالبكسل. إذا كانت المسافة أقل من كل من عرض وارتفاع الخريطة، ستتم إضافة حركة الانتقال بسلاسة. لاحظ أن نظام إحداثيات الخريطة يزداد من الغرب إلى الشرق (للقيم x) ومن الشمال إلى الجنوب (للقيم y).
`panTo`	`panTo(latLng)` المَعلمات: `latLng`: `LatLng\|LatLngLiteral` خط العرض/خط الطول الجديد في وسط الخريطة. القيمة المعروضة: لا شيء يؤدي إلى تغيير مركز الخريطة إلى `LatLng` المحددة. إذا كان التغيير أقل من كل من عرض وارتفاع الخريطة، ستتم إضافة حركة الانتقال بسلاسة.
`panToBounds`	`panToBounds(latLngBounds[, padding])` المَعلمات: `latLngBounds`: `LatLngBounds\|LatLngBoundsLiteral` الحدود المطلوب تحريك الخريطة إليها. `padding`: `number\|Padding optional` المساحة المتروكة بالبكسل. وستحصل قيمة الرقم على المساحة المتروكة نفسها على جميع الجوانب الأربعة. القيمة التلقائية هي 0. القيمة المعروضة: لا شيء لتحريك الخريطة بحسب الحد الأدنى المطلوب لاحتواء `LatLngBounds` المحددة. ولا يضمن هذا الخيار مكان ظهور الحدود على الخريطة، باستثناء أنه سيتم تحريك الخريطة لعرض أكبر قدر ممكن من الحدود داخل `{currentMapSizeInPx} - {padding}`. بالنسبة لكل من خرائط المتجهات والخطوط النقطية، لن يتم تغيير تكبير/تصغير الخريطة وإمالتها وعنوانها.
`setCenter`	`setCenter(latlng)` المَعلمات: `latlng`: `LatLng\|LatLngLiteral` القيمة المعروضة: لا شيء
`setClickableIcons`	`setClickableIcons(value)` المَعلمات: `value`: `boolean` القيمة المعروضة: لا شيء للتحكم في ما إذا كانت رموز الخريطة قابلة للنقر أم لا. يمثل رمز الخريطة نقطة اهتمام، والمعروفة أيضًا باسم نقطة الاهتمام. لإيقاف إمكانية النقر على رموز الخرائط، أدخِل القيمة `false` إلى هذه الطريقة.
`setHeading`	`setHeading(heading)` المَعلمات: `heading`: `number` القيمة المعروضة: لا شيء لضبط عنوان البوصلة للخريطة التي تم قياسها بالدرجات من الاتجاه الأساسي للشمال. بالنسبة إلى الخرائط النقطية، لا تنطبق هذه الطريقة إلا على الصور الجوية.
`setMapTypeId`	`setMapTypeId(mapTypeId)` المَعلمات: `mapTypeId`: `MapTypeId\|string` القيمة المعروضة: لا شيء
`setOptions`	`setOptions(options)` المَعلمات: `options`: `MapOptions optional` القيمة المعروضة: لا شيء
`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`، لأنّ ذلك قد يؤدي إلى تأثيرات غير متوقّعة.
`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()` الوسيطات: بدون يتم تنشيط هذا الحدث عند تغيير الخاصية 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()` الوسيطات: بدون يتم تنشيط هذا الحدث عند تغيير installType.
`tilesloaded`	`function()` الوسيطات: بدون يتم تنشيط هذا الحدث عند الانتهاء من تحميل المربّعات المرئية.
`tilt_changed`	`function()` الوسيطات: بدون يتم تنشيط هذا الحدث عند تغيير خاصية إمالة الخريطة.
`zoom_changed`	`function()` الوسيطات: بدون يتم تنشيط هذا الحدث عند تغيير خاصية التكبير أو التصغير على الخريطة.
`rightclick`	متوقّف نهائيًا: يمكنك استخدام حدث `Map.contextmenu` بدلاً من ذلك لإتاحة أنماط الاستخدام، مثل النقر على مفتاح Control على نظام التشغيل macOS. `function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عندما ينقر المستخدِم بزر الماوس الأيمن على الخريطة.

واجهة MapOptions

واجهة google.maps.MapOptions

MapOptions يُستخدم لتحديد الخصائص التي يمكن تعيينها على الخريطة.

أماكن إقامة
`backgroundColor optional`	النوع: `string optional` اللون المستخدم لخلفية قسم الخريطة. سيكون هذا اللون مرئيًا عندما لا يتم تحميل المربّعات حتى الآن أثناء تنقّل المستخدم. لا يمكن ضبط هذا الخيار إلا عندما يتم إعداد الخريطة.
`center optional`	النوع: `LatLng\|LatLngLiteral optional` مركز الخريطة الأولي.
`clickableIcons optional`	النوع: `boolean optional` الوضع التلقائي: `true` عند عرض `false`، لا تكون رموز الخريطة قابلة للنقر. يمثل رمز الخريطة نقطة اهتمام، والمعروفة أيضًا باسم نقطة الاهتمام.
`controlSize optional`	النوع: `number optional` الحجم بالبكسل لعناصر التحكم التي تظهر على الخريطة. يجب تقديم هذه القيمة مباشرةً عند إنشاء الخريطة، وقد يؤدي تعديل هذه القيمة لاحقًا إلى إضافة عناصر التحكّم إلى حالة `undefined`. يحكم فقط عناصر التحكم التي بواسطة واجهة برمجة التطبيقات للخرائط نفسها. لا يؤدّي إلى توسيع نطاق عناصر التحكّم المخصَّصة التي أنشأها المطوِّرون.
`disableDefaultUI optional`	النوع: `boolean optional` تفعيل/إيقاف جميع أزرار واجهة المستخدم التلقائية يمكن أن يتم تجاهل كل على حدة. لا يتم إيقاف عناصر التحكّم في لوحة المفاتيح التي يتحكّم فيها خيار `MapOptions.keyboardShortcuts` بشكل منفصل. لا يتم إيقاف عناصر التحكّم بالإيماءات التي يتحكّم فيها خيار `MapOptions.gestureHandling` بشكل منفصل.
`disableDoubleClickZoom optional`	النوع: `boolean optional` لتفعيل/إيقاف التكبير/التصغير وتوسيط عند النقر المزدوج. يتم تفعيلها بشكل تلقائي. ملاحظة: هذه السمة لا يُنصح باستخدامها. لإيقاف التكبير أو التصغير عند النقر مرّتين، يمكنك استخدام السمة `gestureHandling` وضبطها على `"none"`.
`draggable optional`	متوقّف نهائيًا: تم إيقافه نهائيًا في عام 2017. لإيقاف السحب على الخريطة، يمكنك استخدام السمة `gestureHandling` وضبطها على `"none"`. النوع: `boolean optional` إذا كان الحقل "`false`"، سيمنع سحب الخريطة. يتم تفعيل ميزة السحب بشكل تلقائي.
`draggableCursor optional`	النوع: `string optional` الاسم أو عنوان URL للمؤشر الذي سيتم عرضه عند تمرير الماوس فوق خريطة قابلة للسحب. تستخدم هذه السمة سمة `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` عنوان الصور الجوية بالدرجات، تم قياسه في اتجاه عقارب الساعة من الاتجاه الأساسي للشمال. يتم تثبيت العناوين باتجاه أقرب زاوية متاحة تتوفر لها الصور.
`isFractionalZoomEnabled optional`	النوع: `boolean optional` تلقائي: `true` لخرائط المتجهات و`false` للخرائط النقطية ما إذا كان يجب أن تسمح الخريطة بمستويات تكبير كسري. يمكنك الاستماع إلى "`isfractionalzoomenabled_changed`" لمعرفة وقت ضبط الإعداد التلقائي.
`keyboardShortcuts optional`	النوع: `boolean optional` إذا كانت القيمة "`false`"، ستمنع لوحة المفاتيح من التحكّم في الخريطة. تكون اختصارات لوحة المفاتيح مفعّلة بشكل تلقائي.
`mapId optional`	النوع: `string optional` رقم تعريف الخريطة للخريطة. لا يمكن تعيين هذه المعلمة أو تغييرها بعد إنشاء مثيل للخريطة.
`mapTypeControl optional`	النوع: `boolean optional` الحالة الأولية لتفعيل/إيقاف عنصر التحكّم في نوع الخريطة.
`mapTypeControlOptions optional`	النوع: `MapTypeControlOptions optional` خيارات العرض الأولية للتحكم في نوع الخريطة.
`mapTypeId optional`	النوع: `MapTypeId\|string optional` معرّف نوع الخريطة الأولي. يكون الإعداد التلقائي هو `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` خيارات العرض لعنصر التحكم في التحريك.
`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`، لأنّ ذلك قد يؤدي إلى تأثيرات غير متوقّعة.
`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" map-id="string" zoom="number"></gmp-map>

تشمل هذه الفئة تجربة "HTMLElement".

ينفِّذ هذا الفئة MapElementOptions.

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

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

أماكن إقامة
`center`	النوع: `LatLng\|LatLngLiteral optional` مركز خط العرض/خط الطول للخريطة. سمة HTML: `<gmp-map center="lat,lng"></gmp-map>`
`innerMap`	النوع: `Map` يشير إلى `Map` الذي يستخدمه MapElement داخليًا.
`mapId`	النوع: `string optional` رقم تعريف الخريطة للخريطة. راجع مستندات معرّف الخريطة للحصول على مزيد من المعلومات. سمة HTML: `<gmp-map map-id="string"></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`.

الطُرق
`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` مركز الخريطة الأولي.
`mapId optional`	النوع: `string optional` رقم تعريف الخريطة للخريطة. لا يمكن تعيين هذه المعلمة أو تغييرها بعد إنشاء مثيل للخريطة.
`zoom optional`	النوع: `number optional` مستوى تكبير/تصغير الخريطة الأولي. قيم التكبير/التصغير الصالحة هي أرقام تبدأ من صفر إلى الحد الأقصى لمستوى التكبير المسموح به. تتوافق قيم التكبير/التصغير الأكبر مع الدقة الأعلى.

فئة ZoomChangeEvent التدريبية

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

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

تشمل هذه الفئة تجربة "Event".

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

واجهة MapTypeStyle

واجهة google.maps.MapTypeStyle

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

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

واجهة MapMouseEvent

واجهة google.maps.MapMouseEvent

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

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

أماكن إقامة

domEvent

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

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

latLng optional

النوع: LatLng optional

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

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

واجهة IconMouseEvent

واجهة google.maps.IconMouseEvent

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

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

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

أماكن إقامة

placeId optional

النوع: string optional

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

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

موروث: domEvent، latLng

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

الثوابت MapTypeId

google.maps.MapTypeId ثابت

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

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

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

فئة MapTypeRegistry

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

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

تشمل هذه الفئة تجربة "MVCObject".

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

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

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

MapTypeRegistry

MapTypeRegistry()

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

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

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

الطُرق

set

set(id, mapType)

المَعلمات:

id: string معرّف MapType المطلوب إضافته إلى قاعدة بيانات المسجّلين.
mapType: MapType|* كائن MapType المراد إضافته إلى قاعدة بيانات المسجّلين.

القيمة المعروضة: لا شيء

لضبط السجل لربط معرّف السلسلة الذي تم تمريره بـ MapType التي تم تمريرها.

تاريخ الاكتساب: addListener، bindTo، get، notify، setValues، unbind، unbindAll

واجهة MapRestriction

واجهة google.maps.MapRestriction

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

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

أماكن إقامة

latLngBounds

النوع: LatLngBounds|LatLngBoundsLiteral

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

strictBounds optional

النوع: boolean optional

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

فئة TrafficLayer

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

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

تشمل هذه الفئة تجربة "MVCObject".

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

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

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

واجهة TrafficLayerOptions

واجهة google.maps.TrafficLayerOptions

كائن TrafficLayerOptions الذي يُستخدم لتحديد الخصائص التي يمكن تعيينها في TrafficLayer.

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

فئة TransitLayer

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

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

تشمل هذه الفئة تجربة "MVCObject".

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

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

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

فئة BicyclingLayer

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

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

تشمل هذه الفئة تجربة "MVCObject".

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

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

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

واجهة CameraOptions

واجهة google.maps.CameraOptions

تُستخدَم لإعداد خيارات الكاميرا على الخريطة.

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

واجهة VisibleRegion

واجهة google.maps.VisibleRegion

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

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

ثابت RenderingType

google.maps.RenderingType ثابت

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

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

واجهة MapCapabilities

واجهة google.maps.MapCapabilities

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

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

أماكن إقامة

isAdvancedMarkersAvailable optional

النوع: boolean optional

إذا كانت القيمة true، يتم تكوين هذه الخريطة بشكل صحيح للسماح باستخدام العلامات المتقدمة. تجدر الإشارة إلى أنّه يجب استيراد مكتبة marker لاستخدام العلامات المتقدمة. يمكنك الاطّلاع على https://goo.gle/gmp-isAdvancedMarkersAvailable للحصول على مزيد من المعلومات.

isDataDrivenStylingAvailable optional

النوع: boolean optional

في حال ضبط هذه السياسة على "صحيح"، يتم ضبط هذه الخريطة بشكلٍ صحيح للسماح باستخدام التصميم المستنِد إلى البيانات لميزة FeatureLayer واحدة على الأقل. لمعرفة مزيد من المعلومات، يمكنك الانتقال إلى https://goo.gle/gmp-data-driven-styling وhttps://goo.gle/gmp-FeatureLayerIsAvailable.

Maps

فئة الخريطة

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

الثوابت

أماكن إقامة

الطُرق

فعاليات

واجهة MapOptions

أماكن إقامة

فئة MapElement

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

أماكن إقامة

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

الطُرق

فعاليات

واجهة MapElementOptions

أماكن إقامة

فئة ZoomChangeEvent التدريبية

واجهة MapTypeStyle

أماكن إقامة

واجهة MapMouseEvent

أماكن إقامة

الطُرق

واجهة IconMouseEvent

أماكن إقامة

الطُرق

الثوابت MapTypeId

الثوابت

فئة MapTypeRegistry

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

الطُرق

واجهة MapRestriction

أماكن إقامة

فئة TrafficLayer

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

الطُرق

واجهة TrafficLayerOptions

أماكن إقامة

فئة TransitLayer

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

الطُرق

فئة BicyclingLayer

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

الطُرق

واجهة CameraOptions

أماكن إقامة

واجهة VisibleRegion

أماكن إقامة

ثابت RenderingType

الثوابت

واجهة MapCapabilities

أماكن إقامة