Map View

فئة LocalContextMapView

google.maps.localContext.LocalContextMapView الصف الدراسي

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

ينفِّذ هذا الصف LocalContextMapViewOptions.

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

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)
المعلّمات: 
  • eventNamestring
  • handlerFunction
قيمة الإرجاع:  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 في LocalLocalMapView، ولن يتم تغيير نمطها. قد يكون للعنصر المرتبط بالخريطة أيضًا أنماط وفئات تم تطبيقها عليه من خلال 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
لإلغاء إعداد عرض منتقي الأماكن. يمكنك تمرير دالة لإلغاء الإعداد التلقائي بشكل ديناميكي عندما يغيّر LocalLocalMapView تنسيقه بسبب تغيير الحجم. قد يتم تحديد الأخطاء والإعدادات غير الصحيحة بشكل غير متزامن، وسيتم تجاهلها (سيتم استخدام الإعدادات التلقائية بدلاً من ذلك، وسيتم تسجيل الأخطاء في وحدة التحكّم). ستؤدي الأخطاء التي يتم اكتشافها أثناء الإنشاء إلى عرض الأخطاء بشكل متزامن.
placeDetailsViewSetup optional
النوع:  (function({
  defaultLayoutMode:PlaceDetailsLayoutMode,
  defaultPosition:PlaceDetailsPosition optional
}): (PlaceDetailsViewSetupOptions optional))|PlaceDetailsViewSetupOptions optional
لإلغاء إعداد عرض تفاصيل المكان. يمكنك تمرير دالة لإلغاء الإعداد التلقائي بشكل ديناميكي عندما يغيّر LocalLocalMapView تنسيقه بسبب تغيير الحجم. قد يتم تحديد الأخطاء والإعدادات غير الصحيحة بشكل غير متزامن، وسيتم تجاهلها (سيتم استخدام الإعدادات التلقائية وتسجيل الأخطاء في وحدة التحكّم). ستؤدي الأخطاء التي يتم اكتشافها أثناء الإنشاء إلى عرض الأخطاء بشكل متزامن.

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

موروثة: origin
addListener
addListener(eventName, handler)
المعلّمات: 
  • eventNamestring
  • handlerFunction
قيمة الإرجاع:  MapsEventListener
لإضافة وظيفة المستمع المحددة إلى اسم الحدث المحدد.

MapDirectionsOptionsLiteral واجهة

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

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

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

HIDDEN منتقي الأماكن مخفي.
SHEET يتم عرض منتقي الأماكن كورقة.

ثوابت PlaceChooserPosition

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

عرض المواضع لمحدد المكان.

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

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

INFO_WINDOW يتم عرض تفاصيل المكان في InfoWindow.
SHEET يتم عرض تفاصيل المكان في ورقة.

ثوابت PlaceDetailsPosition

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

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

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

INLINE_END يتم عرض تفاصيل المكان بشكل مضمن مع الخريطة في نهاية السطر. (في اللغة من اليسار إلى اليمين، هذا يعني أن تفاصيل المكان تقع على يمين الخريطة.)
INLINE_START يتم عرض تفاصيل المكان بشكل مضمن مع الخريطة في بداية السطر. (تعني هذه اللغة من اليسار إلى اليمين أن تفاصيل المكان تقع على يسار الخريطة.)