Maps

فئةالخريطة

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

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

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

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، ستكون الرموز قابلة للنقر على الخريطة.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
المعلّمات: 
  • datasetIdstring
قيمة العرض:  FeatureLayer
تعرض FeatureLayer للسمة datasetId المحددة. يجب ضبط أرقام تعريف مجموعات البيانات في Google Cloud Console. إذا لم يكن رقم تعريف مجموعة البيانات مرتبطًا بنمط الخريطة، أو إذا كان النمط المستند إلى البيانات غير متاح (لا يتوفر رقم تعريف للخريطة، أو بلا مربعات متّجهات، أو طبقات ميزات مستندة إلى البيانات أو مجموعات بيانات تم ضبطها في نمط الخريطة)، سيؤدي ذلك إلى تسجيل خطأ، وسيصبح FeatureLayer.isAvailable الناتج غير صحيح.
getDiv
getDiv()
المعلّمات: بدون
قيمة العرض:  HTMLElement خريطة DiD من الخريطة.
getFeatureLayer
getFeatureLayer(featureType)
المعلّمات: 
قيمة العرض:  FeatureLayer
تعرض FeatureLayer للسمة FeatureType المحدّدة. يجب تفعيل FeatureLayer في Google Cloud Console. إذا لم يتوفّر FeatureLayer من FeatureType المحدّد على هذه الخريطة، أو إذا كان النمط المستند إلى البيانات غير متاح (ما من معرّف خريطة، ولم يتم تفعيل مربعات متّجه، ولم يتم تفعيل FeatureLayer في نمط الخريطة)، سيؤدي ذلك إلى تسجيل خطأ، وسيصبح FeatureLayer.isAvailable الناتج خطأ.
getHeading
getHeading()
المعلّمات: بدون
قيمة العرض:  number|undefined
تعرض عنوان البوصلة للخريطة. يتم قياس قيمة العنوان بالدرجات (باتجاه عقارب الساعة) من الاتجاه الرأسي الشمالي. إذا لم يتم إعداد الخريطة بعد، ستكون النتيجة undefined.
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.
getZoom
getZoom()
المعلّمات: بدون
قيمة العرض:  number|undefined
لعرض تكبير/تصغير الخريطة. إذا لم يتم ضبط التكبير أو التصغير، ستكون النتيجة undefined.
moveCamera
moveCamera(cameraOptions)
المعلّمات: 
قيمة العرض: بدون
تضبط كاميرا الخريطة على الفور خيارات الكاميرا المستهدفة بدون رسوم متحركة.
panBy
panBy(x, y)
المعلّمات: 
  • xnumber عدد وحدات البكسل لتحريك الخريطة في الاتجاه x
  • ynumber عدد وحدات البكسل لتحريك الخريطة في الاتجاه y.
قيمة العرض: بدون
تغيّر مركز الخريطة بالمسافة المحددة بالبكسل. إذا كانت المسافة أقل من عرض وارتفاع الخريطة، فإن عملية الانتقال تتحرك بسلاسة. لاحِظ أن نظام تنسيق الخريطة يزداد من الغرب إلى الشرق (لقيم x) ومن الشمال إلى الجنوب (لقيم y).
panTo
panTo(latLng)
المعلّمات: 
قيمة العرض: بدون
تغيّر منتصف الخريطة إلى 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 درجة عند توفُّر صور بزاوية 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 رقم تعريف الخريطة الذي يمكن استخدامه لنماذج الرموز التي تتطلّب رقم تعريف خريطة. إنّ معرّف الخريطة هذا غير مخصّص للاستخدام في تطبيقات الإنتاج ولا يمكن استخدامه للميزات التي تتطلّب ضبط إعدادات السحابة الإلكترونية (مثل تصميم Cloud).
bounds_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير حدود إطار العرض.
center_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير موقع مركز الخريطة.
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما ينقر المستخدم على الخريطة. يتم عرض حدث MapMouseEvent مع خصائص الموقع الذي تم النقر عليه ما لم يتم النقر على رمز مكان، وفي هذه الحالة يتم عرض IconMouseEvent مع رقم تعريف المكان. أيقونة MoMoEvent و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.
mapcapabilities_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)
الوسيطات: 
يتم تنشيط هذا الحدث عندما ينقر المستخدم بزر الماوس الأيمن على الخريطة.

واجهة 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 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". أثناء استخدام الإصدارَين v3.22 وv3.23، يمكنك اختيار استخدام المجموعة السابقة من عناصر التحكّم بدلاً من عناصر التحكّم الجديدة، ما يجعل عنصر التحكّم في العرض الشامل متاحًا كجزء من مجموعة عناصر التحكّم القديمة. يمكنك الاطّلاع على الميزات الجديدة في الإصدار 3.22 من عناصر التحكّم في الخريطة.

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

ملاحظة: لا يتوفر عنصر التحكم في العرض الشامل ضمن مجموعة عناصر التحكم الجديدة التي تم تقديمها في الإصدار 3.22 من واجهة برمجة تطبيقات JavaScript في "خرائط 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 عند عرض نوع خريطة لا يجب أن يظهر عليه تراكب طريق "التجوّل الافتراضي".
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
حالة تفعيل/إيقاف عنصر التحكّم في Zoom
zoomControlOptions optional
النوع:  ZoomControlOptions optional
خيارات العرض للتحكّم في Zoom.

فئة MapElement

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

MapElement هي فئة فرعية من HTMLElement لعرض الخرائط. بعد تحميل مكتبة maps، يمكن إنشاء خريطة بتنسيق HTML. على سبيل المثال:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID"></gmp-map>

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

العنصر المخصّص:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>

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

ينفّذ هذا الصف MapElementOptions.

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

center
النوع:  LatLng|LatLngLiteral optional
سمة HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
النوع:  Map
مرجع إلى Map الذي يستخدمه MapElement داخليًا.
mapId
النوع:  string optional
سمة HTML:
  • <gmp-map map-id="string"></gmp-map>
zoom
النوع:  number optional
سمة HTML:
  • <gmp-map zoom="number"></gmp-map>
BetaaddEventListener
addEventListener(type, listener[, options])
المعلّمات: 
  • typestring سلسلة حسّاسة لحالة الأحرف تمثل نوع الحدث المطلوب الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى الإشعارات يجب أن تكون دالة أو كائنًا له طريقة المعالجةEventEvent.
  • optionsboolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العرض:  void
تعمل هذه الميزة على إعداد دالة سيتم استدعاؤها عند تسليم الحدث المحدّد إلى الهدف. راجع addEventالاستماعer
BetaremoveEventListener
removeEventListener(type, listener[, options])
المعلّمات: 
  • typestring سلسلة تحدِّد نوع الحدث المطلوب إزالة أداة معالجة الحدث له.
  • listenerEventListener|EventListenerObject أداة معالجة الحدث للمعالج الخاص بالحدث المطلوب إزالته من هدف الحدث.
  • optionsboolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العرض:  void
تتم إزالة أداة معالجة حدث تم تسجيلها سابقًا مع addEventالاستماعين من الهدف. راجِع removeEventالاستماعer

واجهة MapElementOptions

واجهة google.maps.MapElementOptions

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

center optional
النوع:  LatLng|LatLngLiteral optional
مركز الخريطة الأولي.
mapId optional
النوع:  string optional
رقم تعريف الخريطة للخريطة لا يمكن ضبط هذه المَعلمة أو تغييرها بعد إنشاء مثيل للخريطة.
zoom optional
النوع:  number 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 في التنفيذ الداخلي لواجهة برمجة تطبيقات "خرائط Google". بسبب ربط الأحداث الداخلية، قد يكون للدلالة domEvent دلالات مختلفة عن MapMouseEvent (على سبيل المثال، قد يكون MapMouseEvent "النقر" domEvent من النوع KeyboardEvent).
latLng optional
النوع:  LatLng optional
خط العرض/خط الطول الذي كان أسفل المؤشر عند وقوع الحدث.
stop
stop()
المعلّمات: بدون
قيمة العرض:  void
تمنع نشر هذا الحدث بشكل أكبر.

واجهة IconMouseEvent

واجهة google.maps.IconMouseEvent

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

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

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

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

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

ثوابت MapTypeId

google.maps.MapTypeId ثوابت

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

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

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

فئة MapTypeRegistry

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

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

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

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

MapTypeRegistry
MapTypeRegistry()
المعلّمات: بدون
يحتفظ MapTypeRegistry بمجموعة من أنواع الخرائط المخصصة المتاحة للاستخدام. وتعمل واجهة برمجة التطبيقات على الرجوع إلى هذا السجل عند تقديم قائمة بأنواع الخرائط المتاحة ضمن عناصر التحكم، على سبيل المثال.
set
set(id, mapType)
المعلّمات: 
  • idstring معرِّف MapType للإضافة إلى السجلّ
  • mapTypeMapType|* الكائن 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

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

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

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

واجهة كاميراOptions

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

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

واجهة MapCapability

واجهة google.maps.MapCapabilities

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

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