Map View

فئة LocalContextMapView

google.maps.localContext.LocalContextMapView class

تعرِض تجربة "السياق المحلي" مع Map.

تنفّذ هذه الفئة LocalContextMapViewOptions.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {LocalContextMapView} = await google.maps.importLibrary("localContext"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
LocalContextMapView
LocalContextMapView(options)
المَعلمات: 
directionsOptions
يمكنك الاطّلاع على LocalContextMapViewOptions.directionsOptions.
element optional
النوع:  HTMLElement|SVGElement optional
هذا الحقل للقراءة فقط. عنصر نموذج عناصر المستند (DOM) الذي يدعم طريقة العرض
isTransitioningMapBounds
النوع:  boolean
يتم ضبطه على true قبل أن يبدأ LocalContextMapView بتغيير حدود Map الداخلية، ويتم ضبطه على false بعد أن ينتهي LocalContextMapView من تغيير حدود Map الداخلية. (لا يتم ضبطه عند حدوث تغييرات في وضع التنسيق بسبب تغيير الحجم وفقًا للّوحة).
locationBias
النوع:  LocationBias optional
يمكنك الاطّلاع على LocalContextMapViewOptions.locationBias. قد يؤدي تغيير هذه السمة في LocalContextMapView إلى بدء عملية بحث جديدة.
locationRestriction
النوع:  LocationRestriction optional
يمكنك الاطّلاع على LocalContextMapViewOptions.locationRestriction. قد يؤدي تغيير هذه السمة في LocalContextMapView إلى بدء عملية بحث جديدة.
maxPlaceCount
النوع:  number
يمكنك الاطّلاع على LocalContextMapViewOptions.maxPlaceCount. قد يؤدي تغيير هذه السمة في LocalContextMapView إلى بدء عملية بحث جديدة.
placeTypePreferences
النوع:  Array<PlaceTypePreference>
يمكنك الاطّلاع على LocalContextMapViewOptions.placeTypePreferences. قد يؤدي تغيير هذه السمة في LocalContextMapView إلى بدء عملية بحث جديدة. يتم أيضًا قبول Iterable<string|PlaceTypePreference>.
مكتسَبة: map، pinOptionsSetup، placeChooserViewSetup، placeDetailsViewSetup
addListener
addListener(eventName, handler)
المَعلمات: 
  • eventName:  string
  • handler:  Function
القيمة المعروضة:  MapsEventListener
تُضيف دالة أداة مراقبة الأحداث المحدّدة إلى اسم الحدث المحدّد.
hidePlaceDetailsView
hidePlaceDetailsView()
المَعلمات:  بدون
القيمة المعروضة:  لا شيء
إخفاء تفاصيل المكان
search
search()
المَعلمات:  بدون
القيمة المعروضة:  لا شيء
تبحث عن أماكن لعرضها للمستخدم استنادًا إلى maxPlaceCount وplaceTypePreferences وlocationRestriction وlocationBias الحالية.
error
function(event)
الوسيطات: 
يتمّ تشغيل هذا الحدث في حال حدوث خطأ أثناء تنفيذ عملية البحث.
placedetailsviewhidestart
function()
الوسيطات:  بدون
يتم تشغيل هذا الحدث قبل بدء عرض تفاصيل المكان بشكل متحرك.
placedetailsviewshowstart
function()
الوسيطات:  بدون
يتم تشغيل هذا الحدث قبل بدء عرض تفاصيل المكان بالحركة.

LocalContextMapViewOptions واجهة

google.maps.localContext.LocalContextMapViewOptions واجهة

خيارات لإنشاء LocalContextMapView أو الوصول إلى LocalContextMapView حالي
maxPlaceCount
النوع:  number
الحد الأقصى لعدد الأماكن المعروضة عندما تكون قيمة هذه المَعلمة 0، لا تحمِّل "مكتبة السياق المحلي" الأماكن. [0,24]
placeTypePreferences
النوع:  Array<PlaceTypePreference>
أنواع الأماكن التي تريد البحث عنها (ما يصل إلى 10) يتم أيضًا قبول النوع Iterable<string|PlaceTypePreference>، ولكن لا يمكن استخدامه إلا في المتصفّحات التي تتيح استخدام رموز JavaScript بشكل تلقائي.
directionsOptions optional
خيارات تخصيص الاتجاهات في حال عدم ضبطها، سيتم إيقاف الاتجاهات والمسافات.
element optional
النوع:  HTMLElement|SVGElement optional
هذا الحقل للقراءة فقط. عنصر نموذج عناصر المستند (DOM) الذي يدعم طريقة العرض
locationBias optional
النوع:  LocationBias optional
القيمة التلقائية: null
حدود أو إشارات خفيفة لاستخدامها عند البحث عن أماكن
locationRestriction optional
النوع:  LocationRestriction optional
الحدود التي تحدّ من نتائج البحث في حال عدم تحديدها، سيتم حصر النتائج بمساحة عرض الخريطة.
map optional
النوع:  Map optional
مثيل Map تم إنشاؤه من قبل في حال تم تمريرها، سيتم نقل الخريطة إلى نموذج DOM الخاص بـ LocalContextMapView، ولن تتم إعادة تصميمها. قد يتم أيضًا تطبيق أنماط وفئات على العنصر المرتبط بالخريطة بواسطة LocalContextMapView.
pinOptionsSetup optional
النوع:  (function({
  isSelected:boolean,
  isHighlighted:boolean
}): (PinOptions optional))|PinOptions optional
يمكنك ضبط رمز علامة المكان استنادًا إلى حالة الرمز. يتمّ استدعاؤه كلّما تغيّر الإدخال في الدالة المخصّصة للردّ. نقْل دالة لإلغاء الإعداد التلقائي ديناميكيًا عندما ترسم LocalContextMapView علامة المكان. قد يتم تحديد الأخطاء وعمليات الضبط غير الصالحة بشكل غير متزامن، وسيتم تجاهلها (سيتم استخدام الإعدادات التلقائية وتسجيل الأخطاء في وحدة التحكّم).
placeChooserViewSetup optional
النوع:  (function({
  defaultLayoutMode:PlaceChooserLayoutMode,
  defaultPosition:PlaceChooserPosition optional
}): (PlaceChooserViewSetupOptions optional))|PlaceChooserViewSetupOptions optional
تلغي إعدادات عرض أداة اختيار الأماكن. نقْل دالة لإلغاء الإعداد التلقائي ديناميكيًا عندما قد يغيّر LocalContextMapView تنسيقه بسبب تغيير حجمه قد يتم تحديد الأخطاء والإعدادات غير الصالحة بشكل غير متزامن، وسيتم تجاهلها (سيتم استخدام الإعدادات التلقائية بدلاً من ذلك، وسيتم تسجيل الأخطاء في وحدة التحكّم). ستؤدي الأخطاء التي يتم رصدها أثناء الإنشاء إلى ظهور أخطاء بشكل متزامن.
placeDetailsViewSetup optional
النوع:  (function({
  defaultLayoutMode:PlaceDetailsLayoutMode,
  defaultPosition:PlaceDetailsPosition optional
}): (PlaceDetailsViewSetupOptions optional))|PlaceDetailsViewSetupOptions optional
تلغي إعدادات عرض تفاصيل المكان. نقْل دالة لإلغاء الإعداد التلقائي ديناميكيًا عندما قد يغيّر LocalContextMapView تنسيقه بسبب تغيير حجمه قد يتم تحديد الأخطاء وعمليات الضبط غير الصالحة بشكل غير متزامن، وسيتم تجاهلها (سيتم استخدام الإعدادات التلقائية وتسجيل الأخطاء في وحدة التحكّم). ستؤدي الأخطاء التي يتم رصدها أثناء الإنشاء إلى ظهور أخطاء بشكل متزامن.

PlaceTypePreference typedef

google.maps.localContext.PlaceTypePreference typedef

نوع المكان الذي تريد البحث عنه، وأهمية هذا النوع في حال حذف weight، ستحدّد المكتبة الأوزان التلقائية التي قد تتغيّر وتتحسن بمرور الوقت.

{
  type:string,
  weight:number optional
}

فئة MapDirectionsOptions

google.maps.localContext.MapDirectionsOptions class

يوفّر إعدادات للاتجاهات باستخدام LocalContextMapView.

تنفّذ هذه الفئة MapDirectionsOptionsLiteral.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {MapDirectionsOptions} = await google.maps.importLibrary("localContext"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
مكتسَبة: origin
addListener
addListener(eventName, handler)
المَعلمات: 
  • eventName:  string
  • handler:  Function
القيمة المعروضة:  MapsEventListener
تُضيف دالة أداة مراقبة الأحداث المحدّدة إلى اسم الحدث المحدّد.

واجهة MapDirectionsOptionsLiteral

google.maps.localContext.MapDirectionsOptionsLiteral واجهة

يتم قبول القيم الثابتة للكائنات بدلاً من كائنات MapDirectionsOptions، وذلك تسهيلًا في العديد من الأماكن. ويتم تحويلها إلى عناصر MapDirectionsOptions عند عثور واجهة برمجة التطبيقات Maps API عليها.
origin
النوع:  LatLng|LatLngLiteral
نقطة الانطلاق للاتجاهات والمسافة

واجهة PinOptions

google.maps.localContext.PinOptions واجهة

خيارات تخصيص علامة الدبوس
background optional
النوع:  string optional
يمكن أن يكون لون شكل الرمز أي لون صالح لتنسيق CSS.
glyphColor optional
النوع:  string optional
يمكن أن يكون لون الرمز النصي للرمز أي لون صالح في CSS.
scale optional
النوع:  number optional
مقياس الرمز القيمة مطلقة، وليست نسبية إلى الأحجام التلقائية في كل حالة.

واجهة PlaceChooserViewSetupOptions

google.maps.localContext.PlaceChooserViewSetupOptions واجهة

خيارات الإعداد لاختيار الأماكن اطّلِع على مزيد من المعلومات عن ضبط التنسيق ومستوى الرؤية.
layoutMode optional
النوع:  PlaceChooserLayoutMode optional
position optional
النوع:  PlaceChooserPosition optional
يتم تجاهلها عندما layoutMode:HIDDEN. وفي حال عدم تمرير هذه السمة، سيتم تحديد موضع تلقائيًا استنادًا إلى layoutMode.

PlaceChooserLayoutMode الثوابت

google.maps.localContext.PlaceChooserLayoutMode الثوابت

أوضاع التنسيق لاختيار الأماكن

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceChooserLayoutMode} = await google.maps.importLibrary("localContext"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
HIDDEN تم إخفاء أداة اختيار الأماكن.
SHEET يتم عرض أداة اختيار الأماكن كجدول بيانات.

PlaceChooserPosition الثوابت

google.maps.localContext.PlaceChooserPosition الثوابت

عرض مواضع أداة اختيار الأماكن

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceChooserPosition} = await google.maps.importLibrary("localContext"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
BLOCK_END يتم عرض أداة اختيار الأماكن على سطر أسفل الخريطة يمتد إلى نهاية الحاوية.
INLINE_END يتم عرض أداة اختيار الأماكن مضمّنة في الخريطة في نهاية السطر. (في اللغة التي تُكتب من اليسار إلى اليمين، يعني ذلك أنّ أداة اختيار الأماكن تكون على يسار الخريطة).
INLINE_START يتم عرض أداة اختيار الأماكن مضمّنة في الخريطة في بداية السطر. (في اللغة التي تُكتب من اليسار إلى اليمين، يعني ذلك أنّ أداة اختيار الأماكن تكون على يمين الخريطة).

واجهة PlaceDetailsViewSetupOptions

google.maps.localContext.PlaceDetailsViewSetupOptions واجهة

خيارات الإعداد لتفاصيل المكان اطّلِع على مزيد من المعلومات عن ضبط التنسيق ومستوى الرؤية.
hidesOnMapClick optional
النوع:  boolean optional
layoutMode optional
النوع:  PlaceDetailsLayoutMode optional
position optional
النوع:  PlaceDetailsPosition optional
يتم تجاهلها عندما layoutMode:INFO_WINDOW. وفي حال عدم تمرير هذه السمة، سيتم تحديد موضع تلقائيًا استنادًا إلى layoutMode.

PlaceDetailsLayoutMode الثوابت

google.maps.localContext.PlaceDetailsLayoutMode الثوابت

أوضاع التنسيق لتفاصيل المكان

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

PlaceDetailsPosition الثوابت

google.maps.localContext.PlaceDetailsPosition الثوابت

مواضع عرض تفاصيل المكان

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceDetailsPosition} = await google.maps.importLibrary("localContext"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
INLINE_END يتم عرض تفاصيل المكان مضمّنة في الخريطة في نهاية السطر. (في اللغة التي تُكتب من اليسار إلى اليمين، يعني ذلك أنّ تفاصيل المكان تظهر على يسار الخريطة).
INLINE_START يتم عرض تفاصيل المكان مضمّنة في الخريطة في بداية السطر. (في اللغة التي تُكتب من اليسار إلى اليمين، يعني ذلك أنّ تفاصيل المكان تظهر على يمين الخريطة).