Maps

فئة الخريطة

google.maps.Map الصف الدراسي

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

الوصول من خلال الاتصال بـ const {Map} = await google.maps.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

Map
Map(mapDiv[, opts])
المعلّمات: 
  • mapDivHTMLElement سيتم عرض الخريطة لملء هذا العنصر.
  • optsMapOptions optional خيارات
لإنشاء خريطة جديدة داخل حاوية HTML المحددة، والتي تكون عادة عنصر DIV.
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، فعندئذٍ تكون الرموز قابلة للنقر على الخريطة.
getDiv
getDiv()
المعلّمات: بدون
عرض القيمة:  HTMLElement The mapDiv of the map.
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 عدد وحدات البكسل لتحريك الخريطة في اتجاه س.
  • 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
قيمة الإرجاع: بدون
لتعيين اتجاه البوصلة على الخريطة التي يتم قياسها بالدرجات من الاتجاه الأساسي إلى الشمال. بالنسبة إلى الخرائط النقطية، لا تنطبق هذه الطريقة إلا على الصور الجوية.
setMapTypeId
setMapTypeId(mapTypeId)
المعلّمات: 
قيمة الإرجاع: بدون
setOptions
setOptions(options)
المعلّمات: 
قيمة الإرجاع: بدون
setStreetView
setStreetView(panorama)
المعلّمات: 
  • panoramaStreetViewPanorama optional البانوراما المطلوب ربطها بالخريطة.
قيمة الإرجاع: بدون
لربط StreetViewPanorama بالخريطة. تلغي هذه البانوراما StreetViewPanorama التلقائي، مما يسمح للخريطة بربطها بصور بانورامية خارجية خارج الخريطة. يؤدي تعيين العرض البانورامي إلى null إلى ربط الصورة البانورامية المضمّنة الافتراضية بالخريطة مرة أخرى.
setTilt
setTilt(tilt)
المعلّمات: 
  • tiltnumber
قيمة الإرجاع: بدون
بالنسبة إلى الخرائط المتجهة، يتم تعيين زاوية وقوع الخريطة. يتم تقييد القيم المسموح بها وفقًا لمستوى تكبير/تصغير الخريطة. بالنسبة إلى الخرائط النقطية، يتحكم في سلوك التبديل التلقائي لزاوية وقوع الخريطة. القيم الوحيدة المسموح بها هي 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()
الوسيطات: لا شيء
يتم تشغيل هذا الحدث عند تغيير renderingType.
tilesloaded
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند انتهاء تحميل المربعات المرئية.
tilt_changed
function()
الوسيطات: لا شيء
يتم تشغيل هذا الحدث عندما تتغير خاصية إمالة الخريطة.
zoom_changed
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عندما تتغير خاصية تكبير/تصغير الخريطة.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما ينقر المستخدم بزر الماوس الأيمن على الخريطة.

MapOptions واجهة

واجهة 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 للمؤشر المراد عرضه عند تحريك الماوس فوق خريطة يمكن سحبها. تستخدم هذه الخاصية سمة خدمة مقارنة الأسعار (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
عنوان الصور الجوية بالدرجات التي تم قياسها باتجاه عقارب الساعة من اتجاه الكاردينال شمالاً. يتم محاذاة العناوين إلى أقرب زاوية متاحة للصور المتوفرة.
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
معرف MapTypeType المبدئي. ضبط القيمة التلقائية على ROADMAP.
maxZoom optional
النوع:  number optional
الحد الأقصى لمستوى التكبير/التصغير الذي سيتم عرضه على الخريطة. وفي حال حذفه، أو ضبطه على null، يتم استخدام الحد الأقصى من التكبير من نوع الخريطة الحالي بدلاً من ذلك. قيم التكبير أو التصغير الصالحة هي أرقام من صفر إلى الحد الأقصى لمستوى التكبير/التصغير المعتمد.
minZoom optional
النوع:  number optional
الحد الأدنى لمستوى التكبير/التصغير الذي سيتم عرضه على الخريطة. وفي حالة حذفه، أو تعيينه على null، يتم استخدام الحد الأدنى للتكبير/التصغير من نوع الخريطة الحالي بدلاً من ذلك. قيم التكبير أو التصغير الصالحة هي أرقام من صفر إلى الحد الأقصى لمستوى التكبير/التصغير المعتمد.
noClear optional
النوع:  boolean optional
إذا true، فلا تمحو محتويات div الخريطة.
panControl optional
النوع:  boolean optional
حالة التفعيل/الإيقاف لعنصر تحكم العرض الشامل.

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

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

ملاحظة: لا يتوفر عنصر تحكم العرض الشامل في مجموعة عناصر التحكم الجديدة المقدمة في الإصدار 3.22 من واجهة برمجة تطبيقات جافا سكريبت لخرائط Google. أثناء استخدام الإصدارين v3.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 للتنفيذ الداخلي لواجهة برمجة تطبيقات الخرائط. نظرًا لتعيين الحدث الداخلي، قد تحتوي domEvent على دلالات مختلفة عن MapMouseEvent (على سبيل المثال، قد تحتوي "MapMouseEvent "click" على 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 ثوابت

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

الوصول من خلال الاتصال بـ const {MapTypeId} = await google.maps.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

فئة MapTypeRegistry

google.maps.MapTypeRegistry الصف الدراسي

سجل لمثيلات MapType، مرتبط بمعرف MapType.

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

الوصول من خلال الاتصال بـ const {MapTypeRegistry} = await google.maps.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

واجهة تقييد الخرائط

واجهة 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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

فئة BicyclelingLayer

google.maps.BicyclingLayer الصف الدراسي

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

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

الوصول من خلال الاتصال بـ const {BicyclingLayer} = await google.maps.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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 ثوابت

الوصول من خلال الاتصال بـ const {RenderingType} = await google.maps.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

واجهة MapCapabilities

واجهة google.maps.MapCapabilities

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

isAdvancedMarkersAvailable optional
النوع:  boolean optional
isDataDrivenStylingAvailable optional
النوع:  boolean optional