Map View

فئة LocalContextMapView

صف واحد (google.maps.localContext.LocalContextMapView)

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

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

يمكنك الوصول من خلال الاتصال على الرقم const {LocalContextMapView} = await google.maps.importLibrary("localContext"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
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)

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

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

يمكنك الوصول من خلال الاتصال على الرقم const {MapDirectionsOptions} = await google.maps.importLibrary("localContext"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
مُكتسَب: 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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
HIDDEN أداة اختيار الأماكن مخفية.
SHEET يتم عرض أداة اختيار الأماكن كورقة.

ثابت PlaceChooserPosition

google.maps.localContext.PlaceChooserPosition ثابت

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

يمكنك الوصول من خلال الاتصال على الرقم const {PlaceChooserPosition} = await google.maps.importLibrary("localContext"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
INFO_WINDOW يتم عرض تفاصيل المكان في InfoWindow.
SHEET يتم عرض تفاصيل المكان في ورقة.

ثابت PlaceDetailsPosition

google.maps.localContext.PlaceDetailsPosition ثابت

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

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