Maps

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، ويمكن الوصول إليها باستخدام السمة 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])
المَعلمات: 
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
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)
الوسيطات: 
يتم إطلاق هذا الحدث عند تغيير خاصية تكبير/تصغير الخريطة.

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.

فئة الخريطة

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 معرّف الخريطة الذي يمكن استخدامه في نماذج الرموز التي تتطلّب معرّف خريطة لا يُقصد استخدام معرّف الخريطة هذا في تطبيقات الإنتاج، ولا يمكن استخدامه للميزات التي تتطلّب إعدادات السحابة الإلكترونية (مثل "تنسيق الخريطة المستنِد إلى السحابة الإلكترونية").
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، يعني ذلك أنّه يمكن النقر على الرموز على الخريطة.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
المَعلمات: 
  • datasetId:  string
قيمة العائد:  FeatureLayer
تعرض هذه الدالة FeatureLayer لـ datasetId المحدّد. يجب ضبط أرقام تعريف مجموعات البيانات في Google Cloud Console. إذا لم يكن معرّف مجموعة البيانات مرتبطًا بنمط الخريطة، أو إذا لم تكن ميزة "التصميم المستند إلى البيانات" متاحة (لا يتوفّر معرّف خريطة أو مربّعات متّجهة أو طبقات ميزات أو مجموعات بيانات "التصميم المستند إلى البيانات" تم إعدادها في نمط الخريطة)، سيتم تسجيل خطأ، وستكون النتيجة FeatureLayer.isAvailable خطأ.
getDiv
getDiv()
المَعلمات:  بدون
قيمة الإرجاع:  HTMLElement mapDiv الخاص بالخريطة.
getFeatureLayer
getFeatureLayer(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)
المَعلمات: 
القيمة المعروضة:  لا شيء
يضبط كاميرا الخريطة على خيارات الكاميرا المستهدَفة على الفور، بدون أي تأثيرات متحركة.
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)
المَعلمات: 
القيمة المعروضة:  لا شيء
setClickableIcons
setClickableIcons(value)
المَعلمات: 
  • value:  boolean
القيمة المعروضة:  لا شيء
تتحكّم هذه السمة في ما إذا كان يمكن النقر على رموز الخريطة أم لا. يمثّل رمز الخريطة نقطة اهتمام، تُعرف أيضًا باسم "نقطة الاهتمام". لإيقاف إمكانية النقر على رموز الخريطة، مرِّر القيمة false إلى هذه الطريقة.
setHeading
setHeading(heading)
المَعلمات: 
  • heading:  number
القيمة المعروضة:  لا شيء
تضبط هذه السمة اتجاه البوصلة للخريطة بالدرجات من الاتجاه الأساسي الشمال. بالنسبة إلى الخرائط النقطية، لا تنطبق هذه الطريقة إلا على الصور الجوية.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
المَعلمات: 
  • headingInteractionEnabled:  boolean
القيمة المعروضة:  لا شيء
تحدّد هذه السمة ما إذا كانت تفاعلات العناوين مفعّلة. لا يسري هذا الخيار إلا عندما تكون الخريطة خريطة متجهة. في حال عدم ضبطها في الرمز، سيتم استخدام الإعدادات السحابية لمعرّف الخريطة (إذا كانت متاحة).
setMapTypeId
setMapTypeId(mapTypeId)
المَعلمات: 
القيمة المعروضة:  لا شيء
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
setRenderingType
setRenderingType(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)
الوسيطات: 
يتم تنشيط هذا الحدث عندما ينقر المستخدم على الخريطة. يتم عرض MapMouseEvent مع خصائص الموقع الجغرافي الذي تم النقر عليه، ما لم يتم النقر على رمز مكان، وفي هذه الحالة يتم عرض IconMouseEvent مع معرّف المكان. إنّ IconMouseEvent وMapMouseEvent متطابقان، باستثناء أنّ IconMouseEvent يحتوي على حقل رقم تعريف المكان. يمكن دائمًا التعامل مع الحدث على أنّه MapMouseEvent عندما لا يكون رقم تعريف المكان مهمًا. لا يتم تنشيط حدث النقر إذا تم النقر على علامة أو نافذة معلومات.
contextmenu
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM contextmenu على حاوية الخريطة.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما ينقر المستخدم نقرًا مزدوجًا على الخريطة. يُرجى العِلم أنّ حدث النقر سيتم تنشيطه أحيانًا مرّة واحدة وأحيانًا مرّتين، قبل هذا الحدث مباشرةً.
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)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يحرك المستخدم مؤشر الماوس فوق حاوية الخريطة.
mouseout
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يخرج مؤشر الماوس من حاوية الخريطة.
mouseover
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يدخل مؤشر الماوس الخاص بالمستخدم إلى حاوية الخريطة.
projection_changed
function()
الوسيطات:  لا شيء
يتم إطلاق هذا الحدث عند تغيير العرض.
renderingtype_changed
function()
الوسيطات:  لا شيء
يتم إطلاق هذا الحدث عند تغيير renderingType.
tilesloaded
function()
الوسيطات:  لا شيء
يتم تنشيط هذا الحدث عند الانتهاء من تحميل المربّعات المرئية.
tilt_changed
function()
الوسيطات:  لا شيء
يتم تنشيط هذا الحدث عند تغيير خاصية ميل الخريطة.
zoom_changed
function()
الوسيطات:  لا شيء
يتم إطلاق هذا الحدث عند تغيير خاصية تكبير/تصغير الخريطة.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما ينقر المستخدم بزر الماوس الأيمن على الخريطة.

واجهة 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
النوع:  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
النوع:  boolean optional
حالة التفعيل/الإيقاف لعنصر التحكّم "تحريك"

panControlOptions optional
النوع:  PanControlOptions optional
خيارات العرض لعنصر التحكّم "تحريك/تكبير"

renderingType optional
النوع:  RenderingType optional
القيمة التلقائية: RenderingType.RASTER
تحدّد هذه السمة ما إذا كان يجب أن تكون الخريطة نقطية أو متجهة. لا يمكن ضبط هذه المَعلمة أو تغييرها بعد إنشاء مثيل للخريطة. في حال عدم ضبط هذا الخيار، سيحدّد إعداد السحابة الإلكترونية لرقم تعريف الخريطة نوع العرض (إذا كان متاحًا). يُرجى العِلم أنّ الخرائط المتجهة قد لا تكون متاحة لجميع الأجهزة والمتصفحات، وسيتم الرجوع إلى خريطة نقطية عند الحاجة.
restriction optional
النوع:  MapRestriction optional
تحدّد هذه السمة حدودًا تحصر مساحة الخريطة التي يمكن للمستخدمين الوصول إليها. عند ضبط هذا الإعداد، يمكن للمستخدم تحريك الكاميرا وتكبير الصورة أو تصغيرها فقط عندما يبقى عرض الكاميرا ضمن حدود المنطقة.
rotateControl optional
النوع:  boolean optional
حالة زر "التدوير" (مفعَّل أو غير مفعَّل)
rotateControlOptions optional
النوع: