حزمة أدوات Places UI Kit: هي مكتبة جاهزة للاستخدام تتيح للمطوّرين إمكانية التخصيص والتحكّم. ننصحك بتجربتها ومشاركة ملاحظاتك حول تجربتك مع حزمة واجهة المستخدم.

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

Maps

فئة 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، ويمكن الوصول إليها من خلال السمة MapElement.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`، باستخدام عناصر مخصّصة. By default, any custom elements added directly to the `MapElement` will be slotted and rendered in `MapPanes.overlayMouseTarget`. ومع ذلك، قد تتم إعادة تخصيص مكوّنات الويب في Maps JavaScript API إلى خانات `MapElement` الداخلية.

الطُرق
`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.

الطُرق

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

عنصر 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.

فئة Map

صف واحد (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` تعرض هذه الدالة إمكانية النقر على رموز الخريطة. يمثّل رمز الخريطة نقطة اهتمام، تُعرف أيضًا باسم POI. إذا كانت القيمة المعروضة هي `true`، يمكن النقر على الرموز على الخريطة.
`getDatasetFeatureLayer`	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. `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` عدد وحدات البكسل لنقل الخريطة في الاتجاه ص. القيمة المعروضة: لا شيء يغيّر مركز الخريطة حسب المسافة المحدّدة بالبكسل. إذا كانت المسافة أقل من عرض الخريطة وارتفاعها، ستكون الحركة الانتقالية سلسة. يُرجى العِلم أنّ نظام إحداثيات الخريطة يزداد من الغرب إلى الشرق (لقيم 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` القيمة المعروضة: لا شيء تتحكّم هذه السياسة في ما إذا كان يمكن النقر على رموز الخريطة أم لا. يمثّل رمز الخريطة نقطة اهتمام، تُعرف أيضًا باسم POI. لإيقاف إمكانية النقر على رموز الخريطة، مرِّر قيمة `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 interface

واجهة google.maps.MapOptions

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

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

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

الخصائص

domEvent

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

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

latLng optional

النوع: LatLng optional

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

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

واجهة IconMouseEvent

واجهة google.maps.IconMouseEvent

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

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

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

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

ثوابت ColorScheme

ذكرياتك الثابتة في شهر google.maps.ColorScheme

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

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

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

ثوابت MapTypeId

ذكرياتك الثابتة في شهر google.maps.MapTypeId

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

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

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

فئة MapTypeRegistry

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

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

هذه الفئة هي امتداد لـ MVCObject.

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

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

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

MapTypeRegistry

MapTypeRegistry()

المَعلمات: لا تتوفّر أي مَعلمات

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

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

واجهة 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\|null` تعرض هذه الدالة الخريطة التي تظهر عليها هذه الطبقة.
`setMap`	`setMap(map)` المَعلمات: `map`: `Map optional` القيمة المعروضة: لا شيء تعرض هذه الدالة الطبقة على الخريطة المحدّدة. إذا تم ضبط الخريطة على `null`، ستتم إزالة الطبقة.
`setOptions`	`setOptions(options)` المَعلمات: `options`: `TrafficLayerOptions optional` القيمة المعروضة: لا شيء
القيم المكتسَبة: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

واجهة TrafficLayerOptions

واجهة google.maps.TrafficLayerOptions

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

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

فئة TransitLayer

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

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

هذه الفئة هي امتداد لـ 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 interface

واجهة 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` إذا كانت القيمة "صحيح"، يعني ذلك أنّه تم ضبط هذه الخريطة بشكل صحيح للسماح باستخدام محدّدات المواقع المتقدّمة. يُرجى العِلم أنّه لا يزال عليك استيراد مكتبة `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 تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة MapElement

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

الخصائص

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

الطُرق

الفعاليات

MapElementOptions interface

الخصائص

فئة ZoomChangeEvent

فئة Map

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

الثوابت

الخصائص

الطُرق

الفعاليات

MapOptions interface

الخصائص

واجهة MapTypeStyle

الخصائص

واجهة MapMouseEvent

الخصائص

الطُرق

واجهة IconMouseEvent

الخصائص

الطُرق

ثوابت ColorScheme

الثوابت

ثوابت MapTypeId

الثوابت

فئة MapTypeRegistry

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

الطُرق

واجهة MapRestriction

الخصائص

فئة TrafficLayer

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

الطُرق

واجهة TrafficLayerOptions

الخصائص

فئة TransitLayer

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

الطُرق

فئة BicyclingLayer

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

الطُرق

CameraOptions interface

الخصائص

واجهة VisibleRegion

الخصائص

ثوابت RenderingType

الثوابت

واجهة MapCapabilities

الخصائص

Maps