فئة الخريطة
google.maps.Map
الصف الدراسي
يمتد هذا الصف
MVCObject
.
الوصول من خلال الاتصال بـ const {Map} = await google.maps.importLibrary("maps")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الشركة المصنِّعة | |
---|---|
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 ، فعندئذٍ تكون الرموز قابلة للنقر على الخريطة. |
getDiv |
getDiv() المعلّمات: بدون
عرض القيمة:
HTMLElement The mapDiv of the map. |
|
getFeatureLayer(featureType) المعلّمات:
قيمة الإرجاع:
FeatureLayer لعرض FeatureLayer من FeatureType المحددة. يجب تفعيل FeatureLayer في Google Cloud Console. إذا لم يكن FeatureLayer من FeatureType المحدد موجودًا على هذه الخريطة، أو إذا لم يكن النمط المستند إلى البيانات متاحًا (لا يوجد معرف خريطة، ولا مربعات متجهات، ولم يتم تمكين FeatureLayer في نمط الخريطة)، فسوف يؤدي ذلك إلى تسجيل خطأ، وسيكون FeatureLayer.isAvailable الناتج غير صحيح. |
getHeading |
getHeading() المعلّمات: بدون
قيمة الإرجاع:
number|undefined لعرض عنوان البوصلة على الخريطة. يتم قياس قيمة العنوان بالدرجات (في اتجاه عقارب الساعة) من الاتجاه الأساسي إلى الشمال. إذا لم يتم إعداد الخريطة بعد، فستكون النتيجة undefined . |
|
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) المعلّمات:
قيمة الإرجاع: بدون
لتغيير مركز الخريطة بمقدار المسافة المحددة بالبكسل. إذا كانت المسافة أقل من عرض وارتفاع الخريطة، فسيتم نقل الانتقال بشكل سلس. لاحظ أن نظام إحداثيات الخريطة يزداد من الغرب إلى الشرق (لقيم 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 درجة متاحة لمستوى التكبير/التصغير وإطار العرض الحاليين، والتبديل مرة أخرى إلى 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 |
رقم تعريف الخريطة الذي يمكن استخدامه لنماذج الرموز التي تتطلب رقم تعريف الخريطة. معرّف الخريطة هذا غير مخصص للاستخدام في تطبيقات الإنتاج ولا يمكن استخدامه للميزات التي تتطلب تهيئة سحابة إلكترونية (مثل نمط السحاب). |
الأحداث | |
---|---|
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. |
|
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() الوسيطات: لا شيء
يتم تنشيط هذا الحدث عندما تتغير خاصية تكبير/تصغير الخريطة. |
|
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 لتفعيل/إيقاف التكبير/التصغير والتوسيط عند النقر المزدوج. يتم التفعيل بشكل تلقائي. ملاحظة: لا يُنصَح باستخدام هذه السمة. لإيقاف التكبير أو التصغير عند النقر مرّتين، يمكنك استخدام السمة |
|
النوع:
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 يتحكم هذا الإعداد في كيفية تعامل واجهة برمجة التطبيقات مع الإيماءات على الخريطة. القيم المسموح بها:
|
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 ، يتم تعطيل التكبير/التصغير على الخريطة باستخدام بكرة تمرير الماوس. يتم تمكين عجلة التمرير افتراضيًا. ملاحظة: لا يُنصَح باستخدام هذه السمة. لإيقاف التكبير أو التصغير باستخدام عجلة التمرير، يمكنك استخدام الخاصية |
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 |
قواعد النمط المراد تطبيقها على عناصر وعناصر الخريطة المحددة. يتم تطبيق القواعد بالترتيب الذي تحدده في هذه المصفوفة. للحصول على إرشادات حول الاستخدام والقيم المسموح بها، راجع مرجع النمط. |
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) المعلّمات:
قيمة الإرجاع: بدون
تعيّن قاعدة بيانات المسجّلين لربط معرّف السلسلة الذي تم تمريره بنوع الخريطة الذي تم تمريره. |
موروث:
addListener ،
bindTo ،
get ،
notify ،
setValues ،
unbind ،
unbindAll
|
واجهة تقييد الخرائط
واجهة
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")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الشركة المصنِّعة | |
---|---|
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 |