Maps

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

فئة الخريطة

google.maps.Map الصف

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

Map
Map(mapDiv[, opts])
المعلّمات:
  • mapDivHTMLElement سيتم عرض الخريطة لملء هذا العنصر.
  • opts: MapOptions optional خيارات
تُنشئ خريطة جديدة داخل حاوية HTML المحدّدة، وعادةً ما تكون عنصر DIV.
controls
النوع: Array<MVCArray<HTMLElement>>
عناصر تحكّم إضافية للإرفاق بالخريطة لإضافة عنصر تحكّم إلى الخريطة، أضِف عنصر التحكّم's <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 للخريطة ظاهر. بالنسبة إلى الخرائط المتّجهَة، تُحدِّد هذه الطريقة إمالة الخريطة&#39؛ وتتجه إلى قيمها التلقائية الصفرية.
getBounds
getBounds()
المعلّمات: لا شيء
قيمة العرض: LatLngBounds|undefined حدود خط الطول/خط العرض لإطار العرض الحالي.
لعرض حدود lat/lng لإطار العرض الحالي. في حال ظهور أكثر من نسخة واحدة من العالم، تتراوح الحدود في خط الطول من -180 إلى 180 درجة. إذا لم يتم إعداد الخريطة أو تم توسيطها ولم يتم ضبط التكبير/التصغير، ستكون النتيجة undefined. بالنسبة إلى الخرائط المتّجهة ذات الإمالة أو العنوان غير الصفري، تمثّل حدود العرض/الطول المعروضة أصغر مربع حد يتضمن المنطقة المرئية في إطار العرض على الخريطة. اطّلع على MapCanvasProjection.getVisibleRegion لمعرفة المنطقة المرئية بالضبط في إطار عرض الخريطة.
getCenter
getCenter()
المعلّمات: لا شيء
قيمة العرض: LatLng|undefined
لعرض الموضع المعروض في منتصف الخريطة. لاحظ أن العنصر LatLng غير مُغلَّف. يُرجى الاطّلاع على LatLng للحصول على المزيد من المعلومات. إذا لم يتم ضبط المركز أو الحدود، تكون النتيجة undefined.
getClickableIcons
getClickableIcons()
المعلّمات: لا شيء
قيمة العرض: boolean|undefined
تعرض إمكانية النقر على رموز الخريطة. يمثل رمز الخريطة نقطة اهتمام، والمعروفة أيضًا باسم نقطة الاهتمام. إذا كانت القيمة المعروضة هي true، تكون الرموز قابلة للنقر على الخريطة.
getDiv
getDiv()
المعلّمات: لا شيء
قيمة العرض: HTMLElement خريطة Div للخريطة.
BetagetFeatureLayer
getFeatureLayer(featureType)
المعلّمات:
قيمة العرض: FeatureLayer
لعرض FeatureLayer من FeatureType المحددة. يجب تفعيل FeatureLayer في Google Cloud Console. في حال عدم توفّر FeatureLayer من السمة FeatureType المحدّدة على هذه الخريطة، أو في حال عدم توفّر التصميم المستند إلى البيانات (ما مِن معرّف خريطة، وعدم توفّر مربعات متّجه، وعدم تفعيل FeatureLayer في نمط الخريطة)، سيتم تسجيل خطأ، وستكون قيمة FeatureLayer.isAvailable الناتجة خطأ.
getHeading
getHeading()
المعلّمات: لا شيء
قيمة العرض: number|undefined
عرض عنوان البوصلة للخريطة. يتم قياس قيمة العنوان بالدرجات (في اتجاه عقارب الساعة) من الاتجاه الأساسي إلى الشمال. إذا لم يتم إعداد الخريطة بعد، ستكون النتيجة undefined.
BetagetMapCapabilities
getMapCapabilities()
المعلّمات: لا شيء
قيمة العرض: MapCapabilities
لإبلاغ المتصل بالإمكانيات الحالية المتاحة للخريطة استنادًا إلى رقم تعريف الخريطة الذي تم تقديمه.
getMapTypeId
getMapTypeId()
المعلّمات: لا شيء
قيمة العرض: MapTypeId|string|undefined
getProjection
getProjection()
المعلّمات: لا شيء
قيمة العرض: Projection|undefined
عرض Projection الحالي. إذا لم يتم إعداد الخريطة بعد، ستكون النتيجة undefined. استمع إلى حدث projection_changed وتحقّق من قيمته للتأكّد من أنه ليس undefined.
getRenderingType
getRenderingType()
المعلّمات: لا شيء
قيمة العرض: RenderingType
عرض نوع العرض الحالي للخريطة.
getStreetView
getStreetView()
المعلّمات: لا شيء
قيمة العرض: StreetViewPanorama ربط الصورة البانورامية بالخريطة.
تعرض StreetViewPanorama التلقائية التي يتم ربطها بالخريطة، والتي قد تكون بانوراما تلقائية مضمّنة في الخريطة، أو عرض بانوراما مخصص باستخدام setStreetView(). وستنعكس التغييرات على الخريطة بنسبة streetViewControl في عرض هذه البانوراما المرتبطة.
getTilt
getTilt()
المعلّمات: لا شيء
قيمة العرض: number|undefined
لعرض الزاوية الحالية لحدوث الخريطة، بالدرجات من مستوى إطار العرض إلى مستوى الخريطة. بالنسبة إلى الخرائط النقطية، ستكون النتيجة 0 للصور التي يتم التقاطها مباشرةً أو 45 للصور بزاوية 45 درجة. لا تعرض هذه الطريقة القيمة التي حدّدتها setTilt. يُرجى الاطّلاع على setTilt للحصول على التفاصيل.
getZoom
getZoom()
المعلّمات: لا شيء
قيمة العرض: number|undefined
لعرض تكبير/تصغير الخريطة. إذا لم يتم ضبط التكبير/التصغير، تكون النتيجة undefined.
moveCamera
moveCamera(cameraOptions)
المعلّمات:
قيمة العرض: لا شيء
يتم ضبط كاميرا الخريطة على الفور على خيارات الكاميرا المستهدفة بدون رسوم متحركة.
panBy
panBy(x, y)
المعلّمات:
  • xnumber عدد وحدات البكسل لتحريك الخريطة في الاتجاه x.
  • y: number عدد وحدات البكسل لتحريك الخريطة في الاتجاه 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)
المعلّمات:
  • value: boolean
قيمة العرض: لا شيء
يتحكّم في ما إذا كانت رموز الخريطة قابلة للنقر أم لا. يمثل رمز الخريطة نقطة اهتمام، والمعروفة أيضًا باسم نقطة الاهتمام. لإيقاف إمكانية النقر على رموز الخريطة، يمكنك تمرير قيمة false إلى هذه الطريقة.
setHeading
setHeading(heading)
المعلّمات:
  • heading: number
قيمة العرض: لا شيء
لضبط اتجاه البوصلة للخريطة التي يتم قياسها بالدرجات من الاتجاه الأساسي إلى الشمال. بالنسبة إلى الخرائط النقطية، لا تنطبق هذه الطريقة إلا على الصور الجوية.
setMapTypeId
setMapTypeId(mapTypeId)
المعلّمات:
قيمة العرض: لا شيء
setOptions
setOptions(options)
المعلّمات:
قيمة العرض: لا شيء
setStreetView
setStreetView(panorama)
المعلّمات:
قيمة العرض: لا شيء
تربط StreetViewPanorama بالخريطة. تلغي هذه البانوراما القيمة StreetViewPanorama التلقائية، ما يسمح للخريطة بربطها بصورة بانورامية خارجية خارج الخريطة. يؤدي ضبط البانوراما على null إلى ربط الصورة البانورامية التلقائية المضمَّنة مرة أخرى بالخريطة.
setTilt
setTilt(tilt)
المعلّمات:
  • tilt: number
قيمة العرض: لا شيء
بالنسبة إلى الخرائط المتّجهة، يتم ضبط زاوية وقوع الخريطة. ويتم تحديد القيم المسموح بها وفقًا لمستوى تكبير/تصغير الخريطة. بالنسبة إلى الخرائط النقطية، يتحكّم هذا الإعداد في سلوك التبديل التلقائي لزاوية الخريطة. القيمتان الوحيدتان المسموح بهما هما 0 و45. setTilt(0) تتسبب الخريطة في استخدام عرض علوي بمقدار 0 درجة دائمًا بصرف النظر عن مستوى التكبير والتصغير وإطار العرض. setTilt(45) يؤدي التبديل إلى زاوية الإمالة إلى 45 درجة تلقائيًا عند توفّر صور 45° لمستوى التكبير/التصغير الحالي وإطار العرض، والعودة إلى 0 عندما تكون الصور 45° غير متاحة (هذا هو السلوك التلقائي). لا تتوفّر الصور بزاوية 45 درجة إلا لأنواع الخرائط satellite وhybrid، وفي بعض المواقع الجغرافية، وعلى بعض مستويات التكبير أو التصغير. ملاحظة: تعرض getTilt زاوية الإمالة الحالية، وليس القيمة التي تم ضبطها بواسطة setTilt. بما أنّ getTilt وsetTilt تشير إلى أمور مختلفة، لا تستخدم bind() السمة tilt، لأن ذلك قد يؤدي إلى تأثيرات غير متوقّعة.
setZoom
setZoom(zoom)
المعلّمات:
  • zoomnumber تتوافق قيم التكبير أو التصغير الأكبر مع درجة دقة أعلى.
قيمة العرض: لا شيء
إعداد تكبير/تصغير الخريطة
مكتسب: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
DEMO_MAP_ID رقم تعريف الخريطة الذي يمكن استخدامه لعينات الرموز التي تتطلّب رقم تعريف على الخريطة. لم يتم تصميم رقم تعريف الخريطة هذا للاستخدام في تطبيقات الإنتاج ولا يمكن استخدامه للميزات التي تتطلب ضبط السحابة الإلكترونية (مثل تصميم السحابة الإلكترونية).
bounds_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير حدود إطار العرض.
center_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير موقع مركز الخريطة.
click
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عندما ينقر المستخدم على الخريطة. يتم عرض MapMouseEvent مع خصائص الموقع الذي تم النقر عليه ما لم يتم النقر على رمز المكان، وفي هذه الحالة يتم عرض IconMouseEvent برقم تعريف مكان. يكون الرمز IconMouseEvent و MapMouseEvent متطابقًا، باستثناء أن IconMouseEvent يحتوي على حقل "معرّف المكان". يمكن اعتبار الحدث دائمًا حدث MapMouseEvent عندما لا يكون رقم تعريف المكان مهمًا. لا يتم تنشيط حدث النقر إذا تم النقر على علامة أو نافذة معلومات.
contextmenu
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث قائمة سياقات DOM في حاوية الخريطة.
dblclick
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عندما ينقر المستخدم مرتين على الخريطة. تجدر الإشارة إلى أنه سيتم تنشيط حدث النقر أيضًا قبل هذا الحدث مباشرةً.
drag
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث بشكل متكرر أثناء سحب المستخدم للخريطة.
dragend
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب الخريطة.
dragstart
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب الخريطة.
heading_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير خاصية عنوان الخريطة.
idle
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عندما تصبح الخريطة غير نشطة بعد التحريك أو التكبير/التصغير.
isfractionalzoomenabled_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير الخاصية isFractionalZoomEnabled.
Betamapcapabilities_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير إمكانات الخريطة.
maptypeid_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير الخاصية MapTypeId.
mousemove
function(event)
الوسيطات:
يتم تنشيط هذا الحدث كلما تحرك ماوس المستخدم فوق حاوية الخريطة.
mouseout
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عندما يخرج المستخدم الماوس من حاوية الخريطة.
mouseover
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند دخول ماوس المستخدم في حاوية الخريطة.
projection_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير الإسقاط.
renderingtype_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير displayType.
tilesloaded
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند الانتهاء من تحميل المربّعات المرئية.
tilt_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير إمالة الخريطة.
zoom_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير خاصية تكبير/تصغير الخريطة.
rightclick
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عندما ينقر المستخدم بزر الماوس الأيمن على الخريطة.

واجهة MapsOptions

واجهة google.maps.MapOptions

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

backgroundColor optional
النوع: string optional
اللون المستخدم لخلفية خريطة div. سيكون هذا اللون مرئيًا عندما لا يتم تحميل المربّعات بعد. يمكن إعداد هذا الخيار فقط عند إعداد الخريطة.
center optional
النوع: LatLng|LatLngLiteral optional
مركز الخريطة الأولي.
clickableIcons optional
النوع: boolean optional
تلقائي: true
عند النقر على false، لا يمكن النقر على رموز الخريطة. يمثل رمز الخريطة نقطة اهتمام، والمعروفة أيضًا باسم نقطة الاهتمام.
controlSize optional
النوع: number optional
الحجم بالبكسل الذي يظهر لعناصر التحكّم على الخريطة ويجب تقديم هذه القيمة مباشرةً عند إنشاء الخريطة، وقد يؤدي تعديل هذه القيمة لاحقًا إلى جعل عناصر التحكّم في الحالة undefined. تحكم فقط عناصر التحكم التي تم إنشاؤها بواسطة 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
عنوان الصور الجوية بدرجات تم قياسه في اتجاه عقارب الساعة من الاتجاه الأساسي في الشمال. يتم توجيه العناوين إلى أقرب زاوية متاحة للصور المتاحة.
isFractionalZoomEnabled optional
النوع: boolean optional
تلقائي: true لخرائط المتّجه وfalse للخرائط النقطية
ما إذا كانت الخريطة يجب أن تسمح بمستويات تكبير/تصغير جزئية. يمكنك الاستماع إلى isfractionalzoomenabled_changed للتعرف على وقت ضبط الإعداد التلقائي.
keyboardShortcuts optional
النوع: boolean optional
في حال false، يمنع هذا الإجراء التحكُّم في الخريطة من خلال لوحة المفاتيح. يتم تفعيل اختصارات لوحة المفاتيح تلقائيًا.
mapId optional
النوع: string optional
رقم تعريف الخريطة للخريطة. لا يمكن إعداد هذه المعلّمة أو تغييرها بعد إنشاء مثيل للخريطة.
mapTypeControl optional
النوع: boolean optional
الحالة الأولية/غير المفعّلة للتحكم في نوع الخريطة.
mapTypeControlOptions optional
النوع: MapTypeControlOptions optional
خيارات العرض الأولية للتحكم في نوع الخريطة.
mapTypeId optional
النوع: MapTypeId|string optional
ربط MapTypeId المبدئي. القيمة التلقائية هي ROADMAP.
maxZoom optional
النوع: number optional
الحد الأقصى لمستوى التكبير/التصغير الذي سيتم عرضه على الخريطة. وفي حال حذفه، أو ضبطها على null، سيتم استخدام الحد الأقصى من التكبير من نوع الخريطة الحالي بدلاً من ذلك. القيم الصالحة للتكبير أو التصغير هي أرقام تتراوح من صفر إلى الحد الأقصى المسموح به للتكبير/التصغير.
minZoom optional
النوع: number optional
الحد الأدنى لمستوى التكبير/التصغير الذي سيتم عرضه على الخريطة. وسيتم حذف الحد الأدنى للتكبير من نوع الخريطة الحالي بدلاً من ذلك في حال استخدام السمة null. القيم الصالحة للتكبير أو التصغير هي أرقام تتراوح من صفر إلى الحد الأقصى المسموح به للتكبير/التصغير.
noClear optional
النوع: boolean optional
إذا كانت true، امحُ محتوى div على الخريطة.
panControl optional
النوع: boolean optional
حالة التفعيل/الإيقاف لعنصر التحكّم في العرض الشامل.

ملاحظة: لا يتوفر عنصر التحكم في العرض الشامل في مجموعة عناصر التحكم الجديدة التي تم تقديمها في الإصدار 3.22 من واجهة برمجة تطبيقات JavaScript لـ "خرائط Google". أثناء استخدام الإصدارَين 3.22 وv3.23، يمكنك اختيار استخدام مجموعة عناصر التحكّم السابقة بدلاً من عناصر التحكّم الجديدة، ما يجعل عنصر التحكّم في ميزة "العرض الشامل" متاحًا كجزء من مجموعة عناصر التحكّم القديمة. يمكنك الاطّلاع على الميزات الجديدة في "عناصر التحكّم في الخريطة باستخدام الإصدار 3.22".

panControlOptions optional
النوع: PanControlOptions optional
خيارات العرض للتحكم في العرض الشامل.

ملاحظة: لا يتوفر عنصر التحكم في العرض الشامل في مجموعة عناصر التحكم الجديدة التي تم تقديمها في الإصدار 3.22 من واجهة برمجة تطبيقات JavaScript لـ "خرائط Google". أثناء استخدام الإصدارَين 3.22 وv3.23، يمكنك اختيار استخدام مجموعة عناصر التحكّم السابقة بدلاً من عناصر التحكّم الجديدة، ما يجعل عنصر التحكّم في ميزة "العرض الشامل" متاحًا كجزء من مجموعة عناصر التحكّم القديمة. يمكنك الاطّلاع على الميزات الجديدة في "عناصر التحكّم في الخريطة باستخدام الإصدار 3.22".

restriction optional
النوع: MapRestriction optional
لتعريف الحدود التي تقيّد مساحة الخريطة التي يمكن للمستخدمين الوصول إليها. عند الإعداد، يمكن للمستخدم العرض الشامل والتكبير/التصغير فقط أثناء بقاء عرض الكاميرا داخل حدود الحد.
rotateControl optional
النوع: boolean optional
حالة التفعيل/الإيقاف لعنصر التحكم في التدوير.
rotateControlOptions optional
النوع: RotateControlOptions optional
خيارات العرض لعناصر التحكّم في التدوير.
scaleControl optional
النوع: boolean optional
الحالة الأولية/غير المفعّلة للتحكم في المقياس.
scaleControlOptions optional
النوع: ScaleControlOptions optional
خيارات العرض الأولية للتحكم في الحجم.
scrollwheel optional
النوع: boolean optional
في حال تم إيقاف false على تكبير/تصغير الخريطة باستخدام عجلة تمرير الماوس. يتم تفعيل عجلة التمرير تلقائيًا.

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

streetView optional
النوع: StreetViewPanorama optional
StreetViewPanorama لعرضها عند إسقاط دليل التجوّل الافتراضي على الخريطة. في حال عدم تحديد صورة بانورامية، سيتم عرض StreetViewPanorama تلقائي في الخريطة div عند ربط الدليل.
streetViewControl optional
النوع: boolean optional
الحالة الأولية/غير المفعّلة للتحكم في الدليل في ميزة "التجوّل الافتراضي". يعتبر عنصر التحكم هذا جزءًا من واجهة المستخدم التلقائية، ويجب أن يتم ضبطه على false عند عرض نوع خريطة لا يجب أن يظهر عليه تراكب طريق"التجوّل الافتراضي" (على سبيل المثال نوع خريطة غير Earth).
streetViewControlOptions optional
النوع: StreetViewControlOptions optional
خيارات العرض الأولية للتحكم في دليل التجوّل الافتراضي.
styles optional
النوع: Array<MapTypeStyle> optional
الأنماط التي سيتم تطبيقها على كل نوع من أنواع الخرائط التلقائية. لاحظ أنه بالنسبة إلى وضعَي satellite/hybrid وterrain، لن يتم تطبيق هذه الأنماط إلا على التصنيفات والهندسة.
tilt optional
النوع: number optional
بالنسبة إلى الخرائط المتّجهة، يتم ضبط زاوية وقوع الخريطة. ويتم تحديد القيم المسموح بها وفقًا لمستوى تكبير/تصغير الخريطة. بالنسبة إلى الخرائط النقطية، يتحكّم هذا الإعداد في سلوك التبديل التلقائي لزاوية الخريطة. القيمتان الوحيدتان المسموح بهما هما 0 و45. تجعل القيمة 0 الخريطة تستخدم دائمًا عرضًا علويًا بقيمة 0° بغض النظر عن مستوى التكبير والتصغير. تؤدي القيمة 45 إلى التبديل بزاوية إمالة إلى 45 تلقائيًا عندما تكون الصور 45° متاحة لمستوى التكبير/التصغير الحالي وإطار العرض، ثم التبديل مرة أخرى إلى 0 متى لم تكن الصور بزاوية 45 درجة متاحة (هذا هو السلوك التلقائي). لا تتوفّر الصور بزاوية 45 درجة إلا لأنواع الخرائط satellite وhybrid، وفي بعض المواقع الجغرافية، وعلى بعض مستويات التكبير أو التصغير. ملاحظة: تعرض getTilt زاوية الإمالة الحالية، وليس القيمة التي حددها هذا الخيار. بما أنّ getTilt وهذا الخيار يشيران إلى أمور مختلفة، لا تستخدم bind() السمة tilt، لأن ذلك قد يؤدي إلى تأثيرات غير متوقّعة.
zoom optional
النوع: number optional
مستوى التكبير/التصغير الأولي للخريطة. القيم الصالحة للتكبير أو التصغير هي أرقام تتراوح من صفر إلى الحد الأقصى المسموح به للتكبير/التصغير. وتتوافق قيم التكبير أو التصغير الأكبر حجمًا مع درجة دقة أعلى.
zoomControl optional
النوع: boolean optional
حالة التفعيل/الإيقاف للتحكم في التكبير/التصغير.
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
حدث DOM الأصلي المدمج. يجب ألا يعتمد مطوّرو البرامج على سمات target وcurrentTarget وrelatedTarget وpath التي يتم تحديدها واتساقها. يجب أيضًا ألا يعتمد مطوّرو البرامج على بنية DOM في التنفيذ الداخلي لواجهة برمجة تطبيقات Maps. بسبب ربط الأحداث الداخلية، قد تتضمّن السمة domEvent دلالات مختلفة عن MapMouseEvent (مثل MapMouseEvent "click&quot، وقد تحتوي على domEvent من النوع KeyboardEvent).
latLng optional
النوع: LatLng optional
خط العرض/خط الطول الذي كان تحت المؤشر عند وقوع الحدث.
stop
stop()
المعلّمات: لا شيء
قيمة العرض: void
يمنع هذا الحدث من النشر بشكلٍ أكبر.

واجهة IconMouseEvent

واجهة google.maps.IconMouseEvent

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

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

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

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

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

ثواني MapTypeId

google.maps.MapTypeId ثوابت

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

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

فئة MapTypeRegistry

google.maps.MapTypeRegistry الصف

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

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

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

فئة trafficLayer

google.maps.TrafficLayer الصف

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

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

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

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

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

فئة TransitLayer

google.maps.TransitLayer الصف

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

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

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

فئة BicyclelingLayer

google.maps.BicyclingLayer الصف

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

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

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

واجهة مرئية

واجهة google.maps.VisibleRegion

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

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

ثوابت RenderingType

google.maps.RenderingType ثوابت

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

واجهة MapsCapability

واجهة google.maps.MapCapabilities

عنصر يحتوي على نبذة عن الإمكانات المتاحة حاليًا للخريطة. راجِع الخصائص للاطّلاع على قائمة بالإمكانات المحتملة.

BetaisAdvancedMarkersAvailable optional
النوع: boolean optional
BetaisDataDrivenStylingAvailable optional
النوع: boolean optional