فئةالخريطة
صف واحد (google.maps.Map
)
يمتد هذا الصف
MVCObject
.
يمكنك الوصول من خلال الاتصال بـ const {Map} = await google.maps.importLibrary("maps")
. اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
الشركة المصنِّعة | |
---|---|
Map |
Map(mapDiv[, opts]) المعلّمات:
تنشئ خريطة جديدة داخل حاوية HTML المحددة، وعادةً ما تكون عنصر DIV . |
أماكن إقامة | |
---|---|
controls |
النوع:
Array<MVCArray<HTMLElement>> عناصر تحكّم إضافية للإرفاق على الخريطة لإضافة عنصر تحكّم إلى الخريطة، أضِف عنصر التحكّم <div> إلى MVCArray المقابل لـ ControlPosition حيث يجب عرضه. |
data |
النوع:
Data مثال Data ، مرتبط بالخريطة. يمكنك إضافة ميزات إلى العنصر Data لعرضها بسهولة على هذه الخريطة. |
mapTypes |
النوع:
MapTypeRegistry قاعدة بيانات المسجّلين لمثيلَين ( MapType ) حسب رقم تعريف السلسلة |
overlayMapTypes |
أنواع خرائط إضافية تظهر على سطح الفيديو ستُعرض أنواع خريطة التراكب في أعلى الخريطة الأساسية التي يتم إرفاقها بها، بالترتيب الذي تظهر به في مصفوفة overlayMapTypes (يتم عرض التراكبات ذات قيم الفهرس الأعلى قبل العناصر المركّبة ذات قيم الفهرس المنخفضة). |
الطُرق | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) المعلّمات:
قيمة العرض: بدون
يتم ضبط إطار العرض على تضمين الحدود المحدّدة. ملاحظة: عند ضبط الخريطة على display: none ، تقرأ الدالة fitBounds حجم الخريطة على أنه 0x0، وبالتالي لا تفعل أي شيء. لتغيير إطار العرض أثناء إخفاء الخريطة، اضبط الخريطة على visibility: hidden ، وبالتالي تأكّد من أن حجم عنصر div للخريطة فعليًا. بالنسبة إلى الخرائط المتّجهة، تُحدِّد هذه الطريقة إمالة الخريطة وتوجهها إلى قيم الصفر التلقائية. وقد يؤدي طلب هذه الطريقة إلى عرض مؤثرات حركية سلسة، حيث يتم تحريك الخريطة وتكبيرها أو تصغيرها لتلائم الحدود. يعتمد ما إذا كانت هذه الطريقة ستستخدمها في الصور المتحركة أم لا. |
getBounds |
getBounds() المعلّمات: بدون
قيمة العرض:
LatLngBounds|undefined حدود خطوط الطول/العرض الخاصة بإطار العرض الحالي.لعرض حدود خط العرض/خط العرض لإطار العرض الحالي. إذا كان هناك أكثر من نسخة من العالم مرئيًا، يؤدي نطاق الحدود إلى خط الطول من -180 إلى 180 درجة. إذا لم يتم إعداد الخريطة بعد أو لم يتم ضبط التكبير/التصغير ولم يتم ضبط التكبير أو التصغير، ستكون النتيجة undefined . بالنسبة إلى خرائط المتّجه ذات الإمالة أو العنوان غير الصفرات، تمثّل حدود العرض/الخط العرضي أصغر مربع إحاطة يشتمل على المنطقة المرئية من إطار عرض الخريطة. يمكنك الاطّلاع على MapCanvasProjection.getVisibleRegion للحصول على المنطقة المرئية بالضبط في إطار عرض الخريطة. |
getCenter |
getCenter() المعلّمات: بدون
قيمة العرض:
LatLng|undefined |
getClickableIcons |
getClickableIcons() المعلّمات: بدون
قيمة العرض:
boolean|undefined يعرض إمكانية النقر لرموز الخريطة. يمثِّل رمز الخريطة نقطة اهتمام، وتُعرف أيضًا باسم "نقطة اهتمام". إذا كانت القيمة المعروضة هي true ، ستكون الرموز قابلة للنقر على الخريطة. |
|
getDatasetFeatureLayer(datasetId) المعلّمات:
قيمة العرض:
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) المعلّمات:
قيمة العرض: بدون
تغيّر مركز الخريطة بالمسافة المحددة بالبكسل. إذا كانت المسافة أقل من عرض وارتفاع الخريطة، فإن عملية الانتقال تتحرك بسلاسة. لاحِظ أن نظام تنسيق الخريطة يزداد من الغرب إلى الشرق (لقيم x) ومن الشمال إلى الجنوب (لقيم y). |
panTo |
panTo(latLng) المعلّمات:
قيمة العرض: بدون
تغيّر منتصف الخريطة إلى LatLng المحدّد. إذا كان التغيير أقل من عرض كل من ارتفاعه وارتفاعه، سيكون الانتقال سريعًا بسلاسة. |
panToBounds |
panToBounds(latLngBounds[, padding]) المعلّمات:
قيمة العرض: بدون
يمكنك تحريك الخريطة بالحد الأدنى من الكمية المطلوبة لتحتوي على LatLngBounds المحدد. لا يكون هناك ما يضمن إمكانية وضع الحدود على الخريطة، باستثناء أنه سيتم تحريك الخريطة لعرض أكبر قدر ممكن من الحدود داخل {currentMapSizeInPx} - {padding} . بالنسبة إلى الخرائط تلقّي رموز متّجهة والمتّجهين، لن يتم تغيير تكبير الخريطة وإمالتها وعنوانها. |
setCenter |
setCenter(latlng) المعلّمات:
قيمة العرض: بدون
|
setClickableIcons |
setClickableIcons(value) المعلّمات:
قيمة العرض: بدون
يتحكّم هذا الإعداد في إمكانية النقر على رموز الخريطة. يمثِّل رمز الخريطة نقطة اهتمام، وتُعرف أيضًا باسم "نقطة اهتمام". لإيقاف إمكانية النقر على رموز الخريطة، مرِّر القيمة false إلى هذه الطريقة. |
setHeading |
setHeading(heading) المعلّمات:
قيمة العرض: بدون
يحدد عنوان البوصلة للخريطة التي يتم قياسها بالدرجات من الاتجاه الرأسي الشمالي. بالنسبة إلى الخرائط النقطية، لا تنطبق هذه الطريقة إلا على الصور المُلتقطة من الجو. |
setMapTypeId |
setMapTypeId(mapTypeId) المعلّمات:
قيمة العرض: بدون
|
setOptions |
setOptions(options) المعلّمات:
قيمة العرض: بدون
|
setStreetView |
setStreetView(panorama) المعلّمات:
قيمة العرض: بدون
تربط StreetViewPanorama بالخريطة. تلغي هذه البانوراما القيمة التلقائية StreetViewPanorama ، ما يسمح بالربط بالبانوراما الخارجية خارج الخريطة. يؤدي ضبط العرض البانورامي إلى null إلى ربط الصورة البانورامية التلقائية المضمَّنة بالخريطة مرة أخرى. |
setTilt |
setTilt(tilt) المعلّمات:
قيمة العرض: بدون
بالنسبة إلى الخرائط المتّجهة، يتم ضبط زاوية وقوع الخريطة. يتم حظر القيم المسموح بها استنادًا إلى مستوى التكبير أو التصغير في الخريطة. بالنسبة إلى الخرائط النقطية، تتحكم هذه السياسة في سلوك التبديل التلقائي لزاوية وقوع الخريطة. القيمتان الوحيدتان المسموح بهما هما 0 و45 . يتسبب setTilt(0) في استخدام الخريطة دائمًا لعرض علوي 0° بغض النظر عن مستوى التكبير وإطار العرض. يتسبب الزاوية setTilt(45) في التبديل إلى 45 درجة تلقائيًا إلى 45 درجة عند توفُّر صور بزاوية 45 درجة لمستوى التكبير/التصغير الحالي وإطار العرض، والتبديل مرة أخرى إلى 0 عندما لا تكون الصور بزاوية 45 درجة متاحة (هذا هو السلوك التلقائي). لا تتوفّر الصور بزاوية 45 درجة إلا لأنواع الخرائط satellite وhybrid ، وفي بعض المواقع الجغرافية، وفي بعض مستويات التكبير أو التصغير. ملاحظة: تعرض getTilt زاوية الإمالة الحالية، وليس القيمة التي تم ضبطها من خلال setTilt . بما أنّ getTilt وsetTilt يشيران إلى أمرَين مختلفَين، لا تستخدم السمة bind() tilt ، لأنّ ذلك قد يؤدي إلى تأثيرات غير متوقّعة. |
setZoom |
setZoom(zoom) المعلّمات:
قيمة العرض: بدون
ضبط تكبير/تصغير الخريطة |
موروثة:
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() الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير خاصية تكبير الخريطة. |
|
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 لتفعيل/إيقاف التكبير والتصغير والتركيز عند النقر مرتين. مفعَّل تلقائيًا. ملاحظة: لا يُنصح باستخدام هذه السمة. لإيقاف التكبير أو التصغير عند النقر مرّتين، يمكنك استخدام السمة |
|
النوع:
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 يتحكّم هذا الإعداد في كيفية معالجة واجهة برمجة التطبيقات للإيماءات على الخريطة. القيم المسموح بها:
|
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 ، يتم إيقاف تكبير الخريطة باستخدام عجلة تمرير الماوس. وتكون عجلة التمرير مفعّلة تلقائيًا. ملاحظة: لا يُنصح باستخدام هذه السمة. لإيقاف التكبير أو التصغير باستخدام عجلة التمرير، يمكنك استخدام السمة |
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:
|
innerMap |
النوع:
Map مرجع إلى Map الذي يستخدمه MapElement داخليًا. |
mapId |
النوع:
string optional رقم تعريف الخريطة للخريطة اطّلع على مستندات معرّف الخريطة للحصول على مزيد من المعلومات.
سمة HTML:
|
zoom |
النوع:
number optional مستوى تكبير/تصغير الخريطة.
سمة HTML:
|
الطُرق | |
---|---|
|
addEventListener(type, listener[, options]) المعلّمات:
قيمة العرض:
void تعمل هذه الميزة على إعداد دالة سيتم استدعاؤها عند تسليم الحدث المحدّد إلى الهدف. راجع addEventالاستماعer |
|
removeEventListener(type, listener[, options]) المعلّمات:
قيمة العرض:
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 |
قواعد النمط التي يتم تطبيقها على عناصر وعناصر الخريطة المحدّدة يتم تطبيق القواعد بالترتيب الذي تحدّده في هذه المصفوفة. للحصول على إرشادات حول الاستخدام والقيم المسموح بها، راجِع مرجع النمط. |
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) المعلّمات:
قيمة العرض: بدون
لضبط قاعدة بيانات المسجّلين لربط معرّف السلسلة الذي تم تمريره بنوع العلامة الذي تم تمريره. |
مكتسَب:
addListener ،
bindTo ،
get ،
notify ،
setValues ،
unbind ،
unbindAll
|
واجهة MapRestriction
واجهة
google.maps.MapRestriction
هو أحد القيود التي يمكن تطبيقها على الخريطة. ولن يتجاوز إطار عرض الخريطة هذه القيود.
أماكن إقامة | |
---|---|
latLngBounds |
النوع:
LatLngBounds|LatLngBoundsLiteral وعند ضبط السياسة، يمكن للمستخدم إجراء عرض شامل وتكبير/تصغير داخل الحدود المقدمة فقط. يمكن أن تفرض الحدود قيودًا على خط الطول وخط العرض أو يمكن أن تفرض قيودًا على خط العرض فقط. وبالنسبة إلى حدود خطوط العرض فقط، استخدِم خطوط الطول الغربي والشرقي بزاوية -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 للحصول على مزيد من المعلومات. |