نقدّم لك مجموعة أدوات واجهة المستخدم الخاصة بـ Places: هي مكتبة مكوّنات جاهزة للاستخدام ومنخفضة التكلفة تتيح لك إضافة واجهة مستخدم Places المألوفة من "خرائط Google" إلى أي خريطة تختارها. ننصحك بتجربتها و مشاركة ملاحظاتك للمساعدة في رسم مستقبل "منصة Google للتسويق".

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

Maps

فئة الخريطة

google.maps.Map صف

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

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

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

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

الثوابت

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

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

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

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

واجهة MapOptions

google.maps.MapOptions interface

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

الخصائص
`backgroundColor optional`	النوع: `string optional` اللون المستخدَم لخلفية عنصر div الخاص بالخريطة. سيظهر هذا اللون عندما لا يتم تحميل المربّعات بعد أثناء تحريك المستخدم للخريطة. لا يمكن ضبط هذا الخيار إلا عند تهيئة الخريطة.
`cameraControl optional`	النوع: `boolean optional` حالة تفعيل/إيقاف عنصر التحكّم في الكاميرا
`cameraControlOptions optional`	النوع: `CameraControlOptions optional` خيارات العرض لعنصر التحكّم في الكاميرا
`center optional`	النوع: `LatLng\|LatLngLiteral optional` مركز الخريطة الأوّلي.
`clickableIcons optional`	النوع: `boolean optional` القيمة التلقائية: `true` عندما تكون `false`، لا يمكن النقر على رموز الخريطة. يمثّل رمز الخريطة نقطة اهتمام، تُعرف أيضًا باسم "نقطة الاهتمام".
`colorScheme optional`	النوع: `ColorScheme\|string optional` القيمة التلقائية: `ColorScheme.LIGHT` نظام الألوان الأوّلي للخريطة لا يمكن ضبط هذا الخيار إلا عند تهيئة الخريطة.
`controlSize optional`	النوع: `number optional` حجم عناصر التحكّم التي تظهر على الخريطة بالبكسل يجب تقديم هذه القيمة مباشرةً عند إنشاء الخريطة، وقد يؤدي تعديل هذه القيمة لاحقًا إلى وضع عناصر التحكّم في الحالة `undefined`. لا تنطبق إلا على عناصر التحكّم التي توفّرها واجهة برمجة التطبيقات Maps API نفسها. لا يتم تغيير حجم عناصر التحكّم المخصّصة التي أنشأها المطوّر.
`disableDefaultUI optional`	النوع: `boolean optional` تفعيل/إيقاف جميع أزرار واجهة المستخدم التلقائية يمكن تجاهل كل منها بشكل فردي. لا يؤدي ذلك إلى إيقاف عناصر التحكّم في لوحة المفاتيح، والتي يتم التحكّم فيها بشكل منفصل من خلال الخيار `MapOptions.keyboardShortcuts`. لا يؤدي هذا الخيار إلى إيقاف عناصر التحكّم بالإيماءات، والتي يتم التحكّم فيها بشكل منفصل من خلال الخيار `MapOptions.gestureHandling`.
`disableDoubleClickZoom optional`	النوع: `boolean optional` تفعيل/إيقاف التكبير والتوسيط عند النقر المزدوج يكون مفعَّلاً تلقائيًا. ملاحظة: لا يُنصح باستخدام هذه السمة. لإيقاف التكبير عند النقر مرّتين، يمكنك استخدام السمة `gestureHandling` وضبطها على `"none"`.
`draggable optional`	متوقّف نهائيًا: تم إيقافه نهائيًا في عام 2017. لإيقاف إمكانية السحب على الخريطة، يمكنك استخدام السمة `gestureHandling` وضبطها على `"none"`. النوع: `boolean optional` إذا كانت القيمة `false`، يمنع ذلك سحب الخريطة. يتم تفعيل ميزة السحب تلقائيًا.
`draggableCursor optional`	النوع: `string optional` اسم أو عنوان URL الخاص بالمؤشر الذي سيتم عرضه عند تمرير الماوس فوق خريطة قابلة للسحب تستخدم هذه السمة السمة `cursor` في CSS لتغيير الرمز. كما هو الحال مع السمة css، يجب تحديد مؤشر احتياطي واحد على الأقل ليس عنوان URL. على سبيل المثال: `draggableCursor: 'url(http://www.example.com/icon.png), auto;'`.
`draggingCursor optional`	النوع: `string optional` اسم أو عنوان URL الخاص بالمؤشر الذي سيتم عرضه عند سحب الخريطة تستخدم هذه السمة السمة `cursor` في CSS لتغيير الرمز. كما هو الحال مع السمة css، يجب تحديد مؤشر احتياطي واحد على الأقل ليس عنوان URL. على سبيل المثال: `draggingCursor: 'url(http://www.example.com/icon.png), auto;'`.
`fullscreenControl optional`	النوع: `boolean optional` حالة تفعيل/إيقاف زر التحكّم في "ملء الشاشة".
`fullscreenControlOptions optional`	النوع: `FullscreenControlOptions optional` خيارات العرض لعنصر التحكّم في وضع ملء الشاشة
`gestureHandling optional`	النوع: `string optional` يتحكّم هذا الإعداد في طريقة تعامل واجهة برمجة التطبيقات مع الإيماءات على الخريطة. القيم المسموح بها: `"cooperative"`: تؤدي أحداث التمرير وإيماءات اللمس بإصبع واحد إلى تمرير الصفحة، ولا تؤدي إلى تكبير الخريطة أو تحريكها. تتيح إيماءات اللمس بإصبعين تحريك الخريطة وتكبيرها أو تصغيرها. يؤدي تمرير الأحداث مع الضغط على مفتاح Ctrl أو مفتاح ⌘ إلى تكبير الخريطة. في هذا الوضع، تتعاون الخريطة مع الصفحة. `"greedy"`: تؤدي جميع إيماءات اللمس وأحداث التمرير إلى تحريك الخريطة أو تكبيرها/تصغيرها. ‫`"none"`: لا يمكن للمستخدم تحريك الخريطة أو تكبيرها أو تصغيرها باستخدام الإيماءات. ‫`"auto"`: (القيمة التلقائية) تكون معالجة الإيماءات تعاونية أو حريصة، وذلك حسب ما إذا كانت الصفحة قابلة للتمرير أو في إطار iframe.
`heading optional`	النوع: `number optional` تمثّل هذه السمة عنوان صور جوية بالدرجات، ويتم قياسها في اتجاه عقارب الساعة من الاتجاه الأساسي الشمال. يتم ضبط العناوين على أقرب زاوية متاحة تتوفّر لها صور.
`headingInteractionEnabled optional`	النوع: `boolean optional` القيمة التلقائية: `false` تحدّد ما إذا كان يجب أن تسمح الخريطة للمستخدم بالتحكّم في اتجاه الكاميرا (التدوير). لا يسري هذا الخيار إلا عندما تكون الخريطة خريطة متجهة. في حال عدم ضبطها في الرمز، سيتم استخدام الإعدادات السحابية لمعرّف الخريطة (إذا كانت متاحة).
`internalUsageAttributionIds optional`	النوع: `Iterable<string> optional` القيمة التلقائية: `null` تضيف هذه السمة معرّف تحديد مصدر الاستخدام إلى أداة التهيئة، ما يساعد Google في التعرّف على المكتبات والنماذج المفيدة للمطوّرين، مثل استخدام مكتبة تجميع العلامات. لإيقاف إرسال معرّف تحديد المصدر الخاص بالاستخدام، يمكنك حذف هذه السمة أو استبدال القيمة بسلسلة فارغة. سيتم إرسال القيم الفريدة فقط. قد يتم تجاهل أي تغييرات تُجريها على هذه القيمة بعد إنشاء مثيل.
`isFractionalZoomEnabled optional`	النوع: `boolean optional` تلقائي: `true` للخرائط المتجهة و`false` للخرائط النقطية تحديد ما إذا كان يجب أن تسمح الخريطة بمستويات تكبير/تصغير جزئية استمع إلى `isfractionalzoomenabled_changed` لمعرفة ما إذا تم ضبط الإعداد التلقائي.
`keyboardShortcuts optional`	النوع: `boolean optional` إذا كانت القيمة `false`، يمنع ذلك التحكّم في الخريطة باستخدام لوحة المفاتيح. تكون اختصارات لوحة المفاتيح مفعّلة تلقائيًا.
`mapId optional`	النوع: `string optional` معرّف الخريطة لا يمكن ضبط هذه المَعلمة أو تغييرها بعد إنشاء مثيل للخريطة. يمكن استخدام `Map.DEMO_MAP_ID` لتجربة الميزات التي تتطلّب معرّف خريطة ولكنّها لا تتطلّب تفعيل السحابة الإلكترونية.
`mapTypeControl optional`	النوع: `boolean optional` الحالة الأولية المفعَّلة أو غير المفعَّلة لعنصر التحكّم في نوع الخريطة
`mapTypeControlOptions optional`	النوع: `MapTypeControlOptions optional` خيارات العرض الأولية لعنصر التحكّم من النوع "خريطة"
`mapTypeId optional`	النوع: `MapTypeId\|string optional` نوع الخريطة الأوّلي في Map القيمة التلقائية هي `ROADMAP`.
`maxZoom optional`	النوع: `number optional` مستوى التكبير أو التصغير الأقصى الذي سيتم عرضه على الخريطة في حال حذف هذا الخيار أو ضبطه على `null`، سيتم بدلاً من ذلك استخدام الحدّ الأقصى للتكبير من نوع الخريطة الحالي. قيم التكبير أو التصغير الصالحة هي أرقام من صفر إلى أقصى مستوى تكبير أو تصغير متاح.
`minZoom optional`	النوع: `number optional` الحد الأدنى لمستوى التكبير أو التصغير الذي سيتم عرضه على الخريطة في حال حذف هذا الخيار أو ضبطه على `null`، سيتم بدلاً من ذلك استخدام الحد الأدنى لمستوى التكبير من نوع الخريطة الحالي. قيم التكبير أو التصغير الصالحة هي أرقام من صفر إلى أقصى مستوى تكبير أو تصغير متاح.
`noClear optional`	النوع: `boolean optional` إذا كان `true`، لا تمحِ محتوى عنصر Map 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` للخريطة عند إسقاط Pegman.
`streetViewControl optional`	النوع: `boolean optional` الحالة الأولية لعنصر التحكّم في "الدليل" في "التجوّل الافتراضي"، سواء كان مفعّلاً أو غير مفعّل. يشكّل عنصر التحكّم هذا جزءًا من واجهة المستخدم التلقائية، ويجب ضبطه على `false` عند عرض نوع خريطة لا يجب أن يظهر عليه تراكب طرق "التجوّل الافتراضي" (مثل نوع خريطة غير تابع لـ "Google 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 class

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 internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

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

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

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

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

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

الماكينات الشقبية
`control-block-end-inline-center`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.BLOCK_END_INLINE_CENTER`.
`control-block-end-inline-end`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.BLOCK_END_INLINE_END`.
`control-block-end-inline-start`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.BLOCK_END_INLINE_START`.
`control-block-start-inline-center`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.BLOCK_START_INLINE_CENTER`.
`control-block-start-inline-end`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.BLOCK_START_INLINE_END`.
`control-block-start-inline-start`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.BLOCK_START_INLINE_START`.
`control-inline-end-block-center`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.INLINE_END_BLOCK_CENTER`.
`control-inline-end-block-end`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.INLINE_END_BLOCK_END`.
`control-inline-end-block-start`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.INLINE_END_BLOCK_START`.
`control-inline-start-block-center`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.INLINE_START_BLOCK_CENTER`.
`control-inline-start-block-end`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.INLINE_START_BLOCK_END`.
`control-inline-start-block-start`	يضع العنصر الذي تمّت تعبئته في الموضع `ControlPosition.INLINE_START_BLOCK_START`.
`default`	يمكنك إنشاء مكوّنات قابلة لإعادة الاستخدام حول "مكوّنات الويب" في Maps JavaScript، مثل `AdvancedMarkerElement`، باستخدام عناصر مخصّصة. بشكلٍ تلقائي، سيتم إدراج أي عناصر مخصّصة تتم إضافتها مباشرةً إلى `MapElement` وعرضها في `MapPanes.overlayMouseTarget`. ومع ذلك، يمكن إعادة إدخال "مكوّنات الإنترنت" في 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 interface

google.maps.MapElementOptions interface

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

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

ZoomChangeEvent

google.maps.ZoomChangeEvent صف

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

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

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

واجهة MapTypeStyle

google.maps.MapTypeStyle interface

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

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

واجهة MapMouseEvent

google.maps.MapMouseEvent interface

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

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

الخصائص

domEvent

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

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

latLng optional

النوع: LatLng optional

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

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

واجهة IconMouseEvent

google.maps.IconMouseEvent interface

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

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

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

الخصائص

placeId optional

النوع: string optional

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

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

موروثة: domEvent, latLng

الطُرق
موروثة: `stop`

ColorSchemeColorScheme

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

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

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

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

ثوابت MapTypeId

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

معرّفات MapType الشائعة يمكنك تحديدها حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، '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`

MapRestriction

google.maps.MapRestriction interface

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

الخصائص
`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\|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 interface

عنصر 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\|null` تعرِض هذه السمة الخريطة التي يتم عرض هذه الطبقة عليها.
`setMap`	`setMap(map)` المَعلمات: `map`: `Map optional` قيمة العائد: `void` تعرض هذه السمة الطبقة على الخريطة المحدّدة. إذا تم ضبط الخريطة على `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\|null` تعرِض هذه السمة الخريطة التي يتم عرض هذه الطبقة عليها.
`setMap`	`setMap(map)` المَعلمات: `map`: `Map optional` قيمة العائد: `void` تعرض هذه السمة الطبقة على الخريطة المحدّدة. إذا تم ضبط الخريطة على `null`، ستتم إزالة الطبقة.
موروثة: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

واجهة CameraOptions

google.maps.CameraOptions interface

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

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

واجهة VisibleRegion

google.maps.VisibleRegion interface

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

الخصائص
`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 interface

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

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

Maps تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة الخريطة

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

الثوابت

الخصائص

الطُرق

الفعاليات

واجهة MapOptions

الخصائص

MapElement class

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

الخصائص

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

الطُرق

الفعاليات

MapElementOptions interface

الخصائص

ZoomChangeEvent

واجهة MapTypeStyle

الخصائص

واجهة MapMouseEvent

الخصائص

الطُرق

واجهة IconMouseEvent

الخصائص

الطُرق

ColorSchemeColorScheme

الثوابت

ثوابت MapTypeId

الثوابت

فئة MapTypeRegistry

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

الطُرق

MapRestriction

الخصائص

فئة TrafficLayer

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

الطُرق

واجهة TrafficLayerOptions

الخصائص

فئة TransitLayer

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

الطُرق

فئة BicyclingLayer

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

الطُرق

واجهة CameraOptions

الخصائص

واجهة VisibleRegion

الخصائص

ثوابت RenderingType

الثوابت

واجهة MapCapabilities

الخصائص

Maps