Maps

فئة الخريطة

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

تمتد هذه الفئة إلى MVCObject.

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

Map
Map(mapDiv[, opts])
المَعلمات: 
  • mapDivHTMLElement سيتم عرض الخريطة لملء هذا العنصر.
  • optsMapOptions 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])
المَعلمات: 
  • boundsLatLngBounds|LatLngBoundsLiteral من الحدود المسموح بها للعرض.
  • paddingnumber|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)
المَعلمات: 
  • datasetIdstring
قيمة الإرجاع:  FeatureLayer
لعرض FeatureLayer للسمة datasetId المحدّدة. يجب إعداد أرقام تعريف مجموعات البيانات في Google Cloud Console. إذا لم يكن معرّف مجموعة البيانات مرتبطًا بنمط الخريطة للخريطة، أو إذا كان النمط المستند إلى البيانات غير متاح (لا يوجد معرّف خريطة أو بلا مربعات متجهات أو طبقات عناصر تصميم يستند إلى البيانات أو مجموعات بيانات تم ضبطها في نمط الخريطة)، فإن هذا يسجل خطأ، وسيكون FeatureLayer.isAvailable الناتج خطأ.
getDiv
getDiv()
المَعلمات: لا شيء
قيمة الإرجاع:  HTMLElement عنصر خريطة الخريطة.
getFeatureLayer
getFeatureLayer(featureType)
المَعلمات: 
قيمة الإرجاع:  FeatureLayer
تعرض FeatureLayer لـ FeatureType المحددة. يجب تفعيل FeatureLayer في Google Cloud Console. في حال عدم توفّر FeatureLayer من FeatureType المحددة على هذه الخريطة، أو عدم توفّر النمط المستند إلى البيانات (بدون معرّف خريطة أو مربّعات متّجهات وعدم تفعيل FeatureLayer في نمط الخريطة)، يتم تسجيل خطأ، وستكون قيمة FeatureLayer.isAvailable الناتجة خاطئة.
getHeading
getHeading()
المَعلمات: لا شيء
قيمة الإرجاع:  number|undefined
لعرض عنوان بوصلة الخريطة. يتم قياس قيمة العنوان بالدرجات (في اتجاه عقارب الساعة) من الاتجاه الأساسي للشمال. إذا لم يتم إعداد الخريطة إلى الآن، تكون النتيجة undefined.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
المَعلمات: لا شيء
قيمة الإرجاع:  boolean|null
يعرض ما إذا كانت تفاعلات العناوين مفعّلة. لا يكون هذا الخيار ساري المفعول إلا عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط الرمز في رمز، سيتم استخدام إعدادات السحابة الإلكترونية لمعرّف الخريطة (إذا كان ذلك متاحًا).
getMapCapabilities
getMapCapabilities()
المَعلمات: لا شيء
قيمة الإرجاع:  MapCapabilities
إبلاغ المتصل بالإمكانات الحالية المتاحة على الخريطة بناءً على معرّف الخريطة الذي تم تقديمه.
getMapTypeId
getMapTypeId()
المَعلمات: لا شيء
قيمة الإرجاع:  MapTypeId|string|undefined
getProjection
getProjection()
المَعلمات: لا شيء
قيمة الإرجاع:  Projection|undefined
تعرض قيمة Projection الحالية. إذا لم يتم إعداد الخريطة إلى الآن، تكون النتيجة undefined. يُرجى الاستماع إلى حدث "projection_changed" والتحقّق من قيمته للتأكّد من أنّه ليس حدث "undefined".
getRenderingType
getRenderingType()
المَعلمات: لا شيء
قيمة الإرجاع:  RenderingType
لعرض 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)
المَعلمات: 
  • xnumber عدد وحدات البكسل لتحريك الخريطة في الاتجاه x.
  • ynumber عدد وحدات البكسل لتحريك الخريطة في الاتجاه y.
قيمة الإرجاع: لا شيء
لتغيير مركز الخريطة حسب المسافة المحددة بالبكسل. إذا كانت المسافة أقل من كل من عرض وارتفاع الخريطة، فستتم إضافة مؤثرات حركية بسلاسة. لاحظ أن نظام إحداثيات الخريطة يزداد من الغرب إلى الشرق (لقيم x) ومن الشمال إلى الجنوب (لقيم y).
panTo
panTo(latLng)
المَعلمات: 
  • latLngLatLng|LatLngLiteral خط العرض/خط الطول المركزي الجديد للخريطة.
قيمة الإرجاع: لا شيء
تغيير مركز الخريطة إلى LatLng المحددة. إذا كان التغيير أقل من كل من عرض وارتفاع الخريطة، فستتم تحريك الانتقال بسلاسة.
panToBounds
panToBounds(latLngBounds[, padding])
المَعلمات: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral الحدود المطلوب تحريك الخريطة إليها.
  • paddingnumber|Padding optional المساحة المتروكة بالبكسل. سيؤدي استخدام قيمة الرقم إلى الحصول على المساحة المتروكة نفسها على جميع الجوانب الأربعة. القيمة التلقائية هي 0.
قيمة الإرجاع: لا شيء
لتحريك الخريطة إلى الحد الأدنى المطلوب لاحتواء الخريطة على LatLngBounds. ولا يضمن هذا الإجراء مكان ظهور الحدود على الخريطة، إلّا أنّه سيتم تحريك الخريطة لعرض أكبر قدر ممكن من الحدود داخل {currentMapSizeInPx} - {padding}. بالنسبة لكل من الخرائط النقطية والمتجهة، لن يتم تغيير تكبير/تصغير الخريطة وإمالتها وعنوانها.
setCenter
setCenter(latlng)
المَعلمات: 
قيمة الإرجاع: لا شيء
setClickableIcons
setClickableIcons(value)
المَعلمات: 
  • valueboolean
قيمة الإرجاع: لا شيء
تتحكّم هذه السياسة في ما إذا كانت رموز الخريطة قابلة للنقر أم لا. يمثل رمز الخريطة نقطة اهتمام، وتُعرف أيضًا باسم نقطة الاهتمام. لإيقاف إمكانية النقر على رموز الخرائط، اضبط القيمة false على هذه الطريقة.
setHeading
setHeading(heading)
المَعلمات: 
  • headingnumber
قيمة الإرجاع: لا شيء
لضبط عنوان البوصلة للخريطة، تم قياسها بالدرجات من الاتجاه الأساسي للشمال. بالنسبة إلى الخرائط النقطية، تنطبق هذه الطريقة على الصور الجوية فقط.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
المَعلمات: 
  • headingInteractionEnabledboolean
قيمة الإرجاع: لا شيء
تحدِّد هذه السياسة ما إذا كانت تفاعلات العناوين مفعَّلة. لا يكون هذا الخيار ساري المفعول إلا عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط الرمز في رمز، سيتم استخدام إعدادات السحابة الإلكترونية لمعرّف الخريطة (إذا كان ذلك متاحًا).
setMapTypeId
setMapTypeId(mapTypeId)
المَعلمات: 
قيمة الإرجاع: لا شيء
setOptions
setOptions(options)
المَعلمات: 
قيمة الإرجاع: لا شيء
setRenderingType
setRenderingType(renderingType)
المَعلمات: 
قيمة الإرجاع: لا شيء
لضبط RenderingType الحالي للخريطة.
setStreetView
setStreetView(panorama)
المَعلمات: 
  • panoramaStreetViewPanorama optional الصورة البانورامية المراد ربطها بالخريطة.
قيمة الإرجاع: لا شيء
يربط StreetViewPanorama بالخريطة. تتجاوز هذه الصورة البانورامية StreetViewPanorama التلقائية، مما يسمح للخريطة بالربط بإطلالة بانورامية خارجية خارج الخريطة. يؤدي ضبط الصورة البانورامية على null إلى ربط الصورة البانورامية التلقائية المضمّنة في الخريطة مرة أخرى.
setTilt
setTilt(tilt)
المَعلمات: 
  • tiltnumber
قيمة الإرجاع: لا شيء
بالنسبة للخرائط المتجهة، يتم تعيين زاوية الورود للخريطة. يتم تقييد القيم المسموح بها بناءً على مستوى التكبير أو التصغير على الخريطة.

بالنسبة إلى الخرائط النقطية، تتحكّم هذه السياسة في سلوك التبديل التلقائي حسب زاوية وقوع الخريطة. القيمتان المسموح بإدراجهما هما 0 و45 فقط. يؤدي استخدام setTilt(0) إلى استخدام الخريطة دائمًا للعرض من الأعلى إلى الأعلى بغض النظر عن مستوى التكبير أو التصغير وإطار العرض. يؤدّي setTilt(45) إلى تبديل زاوية الإمالة تلقائيًا إلى 45 درجة عندما تتوفّر صور بزاوية 45 درجة لمستوى التكبير/التصغير الحالي وإطار العرض، والتبديل إلى القيمة 0 عند عدم توفّر الصور بزاوية 45 درجة (هذا هو السلوك التلقائي). تتوفر الصور بزاوية 45 درجة فقط لأنواع الخرائط satellite وhybrid، وفي بعض المواقع الجغرافية، وفي بعض مستويات التكبير أو التصغير. ملاحظة: تعرض getTilt زاوية الإمالة الحالية، وليس القيمة التي يتم ضبطها من خلال setTilt. بما أنّ getTilt وsetTilt يشيران إلى أشياء مختلفة، يجب عدم bind() استخدام السمة tilt، لأنّ ذلك قد يؤدي إلى تأثيرات غير متوقّعة.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
المَعلمات: 
  • tiltInteractionEnabledboolean
قيمة الإرجاع: لا شيء
تحدِّد هذه السياسة ما إذا كانت تفاعلات الإمالة مفعّلة أم لا. لا يكون هذا الخيار ساري المفعول إلا عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط الرمز في رمز، سيتم استخدام إعدادات السحابة الإلكترونية لمعرّف الخريطة (إذا كان ذلك متاحًا).
setZoom
setZoom(zoom)
المَعلمات: 
  • zoomnumber تتوافق قيم التكبير/التصغير الأكبر مع درجة دقة أعلى.
قيمة الإرجاع: لا شيء
لضبط تكبير/تصغير الخريطة.
المحتوى المُكتسَب: 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 AuthenticationList على حاوية الخريطة.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما ينقر المستخدِم مرّتين على الخريطة. تجدر الإشارة إلى أنّه سيتم تنشيط حدث النقر مرّة واحدة وأحيانًا مرّتين، قبل هذا الحدث مباشرةً.
drag
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث بشكلٍ متكرر أثناء سحب المستخدم للخريطة.
dragend
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب الخريطة.
dragstart
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب الخريطة.
heading_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير خاصية عنوان الخريطة.
idle
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عندما تصبح الخريطة في وضع عدم النشاط بعد العرض الشامل أو التكبير/التصغير.
isfractionalzoomenabled_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير الخاصية isFracationsZoomEnabled.
mapcapabilities_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عندما تتغير إمكانات الخريطة.
maptypeid_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير خاصية mapTypeId.
mousemove
function(event)
الوسيطات: 
يتمّ تنشيط هذا الحدث عندما يتحرك ماوس المستخدِم فوق حاوية الخريطة.
mouseout
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يخرج المستخدم بمؤشر الماوس من حاوية الخريطة.
mouseover
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يدخل ماوس المستخدم إلى حاوية الخريطة.
projection_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير التوقع.
renderingtype_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير arrangeType.
tilesloaded
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند الانتهاء من تحميل المربّعات المرئية.
tilt_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير خاصية إمالة الخريطة.
zoom_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير خاصية التكبير أو التصغير على الخريطة.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما ينقر المستخدِم بزر الماوس الأيمن على الخريطة.

واجهة MapOptions

واجهة google.maps.MapOptions

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

backgroundColor optional
النوع:  string optional
اللون المستخدم لخلفية قسم الخريطة. سيكون هذا اللون مرئيًا عندما لا يتم تحميل الفئات حتى الآن أثناء تحرك المستخدم. لا يمكن ضبط هذا الخيار إلا عندما يتم إعداد الخريطة.
center optional
النوع:  LatLng|LatLngLiteral optional
تمثّل هذه السمة مركز الخريطة الأولي.
clickableIcons optional
النوع:  boolean optional
الخيار التلقائي: true
عند عرض false، لا تكون رموز الخرائط قابلة للنقر. يمثل رمز الخريطة نقطة اهتمام، وتُعرف أيضًا باسم نقطة الاهتمام.
controlSize optional
النوع:  number optional
الحجم بالبكسل لعناصر التحكم التي تظهر على الخريطة. يجب تقديم هذه القيمة مباشرةً عند إنشاء الخريطة، وقد يؤدي تعديلها في وقت لاحق إلى تغيير عناصر التحكّم إلى حالة undefined. يتحكّم فقط في عناصر التحكّم التي توفّرها واجهة برمجة تطبيقات الخرائط نفسها. لا يؤدي إلى توسيع نطاق عناصر التحكّم المخصّصة التي أنشأها المطوّر.
disableDefaultUI optional
النوع:  boolean optional
تفعيل/إيقاف جميع أزرار واجهة المستخدم التلقائية. يمكن تجاهل هذا الخيار بشكل فردي. ولا يتم إيقاف عناصر تحكّم لوحة المفاتيح التي يتحكّم فيها خيار MapOptions.keyboardShortcuts بشكل منفصل. لا يتم إيقاف عناصر التحكّم بالإيماءات التي يتحكّم فيها خيار MapOptions.gestureHandling بشكل منفصل.
disableDoubleClickZoom optional
النوع:  boolean optional
لتفعيل/إيقاف التكبير/التصغير والتوسيط عند النقر مرّتين. يتم تفعيلها تلقائيًا.

ملاحظة: هذه السمة لا يُنصَح باستخدامها. لإيقاف التكبير أو التصغير عند النقر مرّتين، يمكنك استخدام السمة gestureHandling، وضبطها على "none".

draggable optional
النوع:  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
ما إذا كان يجب أن تسمح الخريطة للمستخدم بالتحكّم في عنوان الكاميرا (التدوير) لا يكون هذا الخيار ساري المفعول إلا عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط الرمز في رمز، سيتم استخدام إعدادات السحابة الإلكترونية لمعرّف الخريطة (إذا كان ذلك متاحًا).
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، يُرجى عدم محو محتوى قسم "الخريطة".
panControl optional
النوع:  boolean optional
حالة التفعيل/الإيقاف لعنصر التحكّم في العرض الشامل

panControlOptions optional
النوع:  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 إلى استخدام الخريطة دائمًا للعرض العلوي بغض النظر عن مستوى التكبير/التصغير وإطار العرض. تؤدي القيمة 45 إلى تبديل زاوية الإمالة تلقائيًا إلى 45 درجة عند توفّر صور بزاوية 45 درجة لمستوى التكبير أو التصغير الحالي وإطار العرض، والتبديل إلى القيمة 0 عند عدم توفّر الصور بزاوية 45 درجة (هذا هو السلوك التلقائي). تتوفر الصور بزاوية 45 درجة فقط لأنواع الخرائط satellite وhybrid، وفي بعض المواقع الجغرافية، وفي بعض مستويات التكبير أو التصغير. ملاحظة: تعرض دالة getTilt زاوية الإمالة الحالية، وليس القيمة التي يحدّدها هذا الخيار. بما أنّ السمة getTilt وهذا الخيار يشيران إلى أشياء مختلفة، يجب عدم استخدام السمة bind() مع السمة tilt، لأنّ ذلك قد يؤدي إلى تأثيرات غير متوقّعة.
tiltInteractionEnabled optional
النوع:  boolean optional
الخيار التلقائي: false
ما إذا كان يجب أن تسمح الخريطة للمستخدم بالتحكّم في إمالة الكاميرا لا يكون هذا الخيار ساري المفعول إلا عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط الرمز في رمز، سيتم استخدام إعدادات السحابة الإلكترونية لمعرّف الخريطة (إذا كان ذلك متاحًا).
zoom optional
النوع:  number optional
مستوى التكبير/التصغير الأولي للخريطة. قيم التكبير/التصغير الصالحة هي أرقام تتراوح بين صفر وتصل إلى الحد الأقصى لمستوى التكبير المسموح به. تتوافق قيم التكبير/التصغير الأكبر مع درجة دقة أعلى.
zoomControl optional
النوع:  boolean optional
الحالة المفعّلة أو غير المفعَّلة لعنصر التحكّم في التكبير/التصغير.
zoomControlOptions optional
النوع:  ZoomControlOptions optional
خيارات العرض لعنصر التحكّم في التكبير/التصغير

فئة MapElement

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

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

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

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

العنصر المخصّص:
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

تمتد هذه الفئة إلى HTMLElement.

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

يمكنك الوصول من خلال الاتصال على الرقم const {MapElement} = await google.maps.importLibrary("maps"). يمكنك الاطّلاع على المكتبات في 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 داخليًا.
mapId
النوع:  string optional
رقم تعريف الخريطة للخريطة. لا يمكن تعيين هذه المعلمة أو تغييرها بعد إنشاء مثيل للخريطة. يمكن استخدام Map.DEMO_MAP_ID لتجربة الميزات التي تتطلّب معرّف الخريطة والتي لا تتطلّب تفعيل السحابة الإلكترونية.
سمة HTML:
  • <gmp-map map-id="string"></gmp-map>
renderingType
النوع:  RenderingType optional
الخيار التلقائي: RenderingType.VECTOR
ما إذا كان يجب أن تكون الخريطة خريطة نقطية أو متجهة. لا يمكن تعيين هذه المعلمة أو تغييرها بعد إنشاء مثيل للخريطة. وفي حال ترك هذه السياسة بدون ضبط، ستحدِّد إعدادات السحابة الإلكترونية لمعرّف الخريطة نوع العرض (إذا كان متاحًا). يُرجى ملاحظة أن خرائط المتجهات قد لا تكون متاحة لجميع الأجهزة والمتصفحات، وستعود الخريطة إلى خريطة نقطية حسب الحاجة.
سمة HTML:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
النوع:  boolean optional
الخيار التلقائي: false
ما إذا كان يجب أن تسمح الخريطة للمستخدم بالتحكّم في إمالة الكاميرا لا يكون هذا الخيار ساري المفعول إلا عندما تكون الخريطة خريطة اتجاهية. إذا لم يتم ضبط الرمز في رمز، سيتم استخدام إعدادات السحابة الإلكترونية لمعرّف الخريطة (إذا كان ذلك متاحًا).
سمة HTML:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
النوع:  number optional
مستوى تكبير/تصغير الخريطة. قيم التكبير/التصغير الصالحة هي أرقام تتراوح بين صفر وتصل إلى الحد الأقصى لمستوى التكبير المسموح به. تتوافق قيم التكبير/التصغير الأكبر مع درجة دقة أعلى.
سمة HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
يضع العنصر المثقوب في الموضع ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
يضع العنصر المثقوب في الموضع ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
يضع العنصر المثقوب في الموضع ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
يضع العنصر المثقوب في الموضع ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
يضع العنصر المثقوب في الموضع ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
يضع العنصر المثقوب في الموضع ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
يضع العنصر المثقوب في الموضع ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
يضع العنصر المثقوب في الموضع ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
يضع العنصر المثقوب في الموضع ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
يضع العنصر المثقوب في الموضع ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
يضع العنصر المثقوب في الموضع ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
يضع العنصر المثقوب في الموضع ControlPosition.INLINE_START_BLOCK_START.
default
يمكنك إنشاء مكوِّنات قابلة لإعادة الاستخدام حول مكوّنات الويب المستندة إلى JavaScript في "خرائط Google"، مثل AdvancedMarkerElement، باستخدام عناصر مخصّصة. بشكل تلقائي، سيتم وضع أي عناصر مخصّصة تتم إضافتها مباشرةً إلى MapElement ضمن الخانات وعرضها في MapPanes.overlayMouseTarget. ومع ذلك، قد تتم إعادة تقسيم مكونات الويب لواجهة برمجة تطبيقات JavaScript لـ "خرائط Google" إلى الخانات الداخلية في MapElement.
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حسّاسة لحالة الأحرف وتمثِّل نوع الحدث المطلوب الاستماع إليه
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقةhandEvent
  • optionsboolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتوافق الأحداث المخصّصة إلّا مع capture وpassive.
قيمة الإرجاع:  void
لإعداد دالة سيتم استدعاؤها كلما تم تسليم الحدث المحدد إلى الهدف. الاطّلاع على addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدِّد نوع الحدث المطلوب إزالة أداة معالجة الحدث منه.
  • listenerEventListener|EventListenerObject أداة معالجة الحدث لمعالج الحدث المطلوب إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة الإرجاع:  void
لإزالة أداة معالجة حدث تم تسجيلها سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener
gmp-zoomchange
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تغيير خاصية التكبير أو التصغير على الخريطة.

واجهة MapElementOptions

واجهة google.maps.MapElementOptions

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

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

فئة ZoomChangeEvent

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

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

تمتد هذه الفئة إلى Event.

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

الواجهة MapTypeStyle

واجهة google.maps.MapTypeStyle

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

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

واجهة MapMouseEvent

واجهة google.maps.MapMouseEvent

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

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

واجهة IconMouseEvent

واجهة google.maps.IconMouseEvent

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

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

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

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

مُكتسَب: domEvent، latLng
مُكتسَب: stop

الثوابت 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 على مجموعة أنواع الخرائط المخصصة المتوفرة للخريطة لاستخدامها. وتشير واجهة برمجة التطبيقات إلى هذا السجلّ عند تقديم قائمة بأنواع الخرائط المتاحة ضمن عناصر التحكّم، على سبيل المثال.
set
set(id, mapType)
المَعلمات: 
  • idstring معرّف MapType المطلوب إضافته إلى السجلّ.
  • mapTypeMapType|* كائن MapType المراد إضافته إلى قاعدة بيانات المسجّلين.
قيمة الإرجاع: لا شيء
لضبط السجلّ على ربط معرّف السلسلة الذي تم تمريره بنوع MapType الذي تم تمريره.
المحتوى المُكتسَب: addListener، bindTo، get، notify، setValues، unbind، unbindAll

واجهة MapRestriction

واجهة google.maps.MapRestriction

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

latLngBounds
وعند الضبط، يمكن للمستخدم فقط العرض الشامل والتكبير/التصغير داخل الحدود المعيّنة. يمكن أن تقيّد الحدود خطوط الطول والعرض على حد سواء، أو يمكن أن تقيّد خطوط العرض فقط. بالنسبة إلى حدود خطوط العرض فقط، استخدِم خطيّ الطول الغربي والشرقي -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])
المَعلمات: 
طبقة تعرض حركة المرور الحالية على الطريق.
getMap
getMap()
المَعلمات: لا شيء
قيمة الإرجاع:  Map
لعرض الخريطة التي يتم عرض هذه الطبقة عليها.
setMap
setMap(map)
المَعلمات: 
قيمة الإرجاع: لا شيء
يعرض الطبقة على الخريطة المحددة. في حال ضبط الخريطة على null، ستتم إزالة الطبقة.
setOptions
setOptions(options)
المَعلمات: 
قيمة الإرجاع: لا شيء
المحتوى المُكتسَب: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

واجهة TrafficLayerOptions

واجهة google.maps.TrafficLayerOptions

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

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

فئة TransitLayer

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

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

تمتد هذه الفئة إلى MVCObject.

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

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

فئة BicyclingLayer

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

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

تمتد هذه الفئة إلى MVCObject.

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

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

واجهة CameraOptions

واجهة google.maps.CameraOptions

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

center optional
النوع:  LatLngLiteral|LatLng optional
heading optional
النوع:  number optional
tilt optional
النوع:  number optional
zoom optional
النوع:  number optional

واجهة VisibleRegion

واجهة google.maps.VisibleRegion

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

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

القيم الثابتة RenderingType

google.maps.RenderingType ثابت

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

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

واجهة MapCapabilities

واجهة google.maps.MapCapabilities

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

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