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 interface

google.maps.localContext.LocalContextMapViewOptions interface

خيارات لإنشاء 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 تم إنشاؤه من قبل. في حال تم تمريرها، سيتم نقل الخريطة إلى نموذج المستند الخاص بـ 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 صف

توفّر هذه الخدمة إعدادات للاتجاهات باستخدام