Map View

فئة LocalContextMapView

google.maps.localContext.LocalContextMapView صف

تم إيقافها نهائيًا: تم إيقاف ميزة "السياق المحلي" نهائيًا، ولم يعُد يُنصح باستخدامها للمواقع الإلكترونية الجديدة. ستظلّ الميزة تعمل، وسيتم إرسال إشعار قبل 12 شهرًا من إيقافها نهائيًا. إذا كنت مهتمًا بإنشاء تجربة مشابهة لتجربة "السياق المحلي" بنفسك، نقترح عليك الاطّلاع على حلّ "استكشاف الحي" في Quick Builder أو استخدام مكتبة الأماكن، Maps JavaScript API. يمكن أن تساعدك نماذج الرموز والدروس التطبيقية حول الترميز الخاصة بمكتبة Places.

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {LocalContextMapView} = await google.maps.importLibrary("localContext").
اطّلِع على المكتبات في Maps JavaScript API.

الشركة المصنِّعة
LocalContextMapView	LocalContextMapView(options) المَعلمات:  options:  LocalContextMapViewOptions

الخصائص
directionsOptions	النوع:  MapDirectionsOptions|MapDirectionsOptionsLiteral optional يمكنك الاطّلاع على 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) الوسيطات:  event:  ErrorEvent يتم إطلاق هذا الحدث في حال حدوث خطأ أثناء إجراء البحث.
placedetailsviewhidestart	function() الوسيطات:  لا شيء يتم تنشيط هذا الحدث قبل أن تبدأ تفاصيل المكان في التحرك خارج الشاشة.
placedetailsviewshowstart	function() الوسيطات:  لا شيء يتم تنشيط هذا الحدث قبل بدء ظهور تفاصيل المكان في صورة متحركة.

LocalContextMapViewOptions interface

google.maps.localContext.LocalContextMapViewOptions interface

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

خيارات لإنشاء LocalContextMapView أو الوصول إلى LocalContextMapView حالي

الخصائص
maxPlaceCount	النوع:  number تمثّل هذه السمة الحد الأقصى لعدد الأماكن المطلوب عرضها. عندما تكون قيمة هذه المَعلمة 0، لا تحمّل "مكتبة السياق المحلي" الأماكن. [0,24]
placeTypePreferences	النوع:  Array<PlaceTypePreference> أنواع الأماكن التي تريد البحث عنها (ما يصل إلى 10 أنواع) يتم قبول النوع Iterable<string|PlaceTypePreference> أيضًا، ولكنّه لا يتوافق إلا مع المتصفّحات التي تتوافق بشكلٍ أصلي مع رموز JavaScript.
directionsOptions optional	النوع:  MapDirectionsOptions|MapDirectionsOptionsLiteral 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

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

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

{
  type:string,
  weight:number optional
}

فئة MapDirectionsOptions

google.maps.localContext.MapDirectionsOptions صف

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

توفّر هذه الخدمة إعدادات للاتجاهات باستخدام 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 interface

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

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

الخصائص
origin	النوع:  LatLng|LatLngLiteral نقطة الانطلاق للحصول على الاتجاهات والمسافة

واجهة PinOptions

google.maps.localContext.PinOptions interface

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

خيارات تخصيص علامة الدبوس

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

واجهة PlaceChooserViewSetupOptions

google.maps.localContext.PlaceChooserViewSetupOptions interface

خيارات الإعداد لأداة اختيار الأماكن مزيد من المعلومات عن ضبط التنسيق ومستوى الظهور

الخصائص
layoutMode optional	النوع:  PlaceChooserLayoutMode optional
position optional	النوع:  PlaceChooserPosition optional يتم تجاهلها عند layoutMode:HIDDEN. في حال عدم تمريرها، سيتم تحديد موضع تلقائيًا استنادًا إلى layoutMode.

PlaceChooserLayoutMode constants

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

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceChooserLayoutMode} = await google.maps.importLibrary("localContext").
اطّلِع على المكتبات في Maps JavaScript API.

الثوابت
HIDDEN	تم إخفاء أداة اختيار المكان.
SHEET	يظهر أداة اختيار المكان كصفحة.

ثوابت PlaceChooserPosition

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

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceChooserPosition} = await google.maps.importLibrary("localContext").
اطّلِع على المكتبات في Maps JavaScript API.

الثوابت
BLOCK_END	يظهر أداة اختيار الموقع الجغرافي على سطر أسفل الخريطة يمتد إلى نهاية الحاوية.
INLINE_END	يتم عرض أداة اختيار المكان بشكل مضمّن مع الخريطة في نهاية السطر. (في اللغات التي تُكتب من اليسار إلى اليمين، يعني ذلك أنّ أداة اختيار المكان تظهر على يسار الخريطة).
INLINE_START	يتم عرض أداة اختيار المكان بشكل مضمّن مع الخريطة في بداية السطر. (في اللغة التي تُكتب من اليسار إلى اليمين، يعني هذا أنّ أداة اختيار المكان تقع على يسار الخريطة).

واجهة PlaceDetailsViewSetupOptions

google.maps.localContext.PlaceDetailsViewSetupOptions interface

خيارات الإعداد لتفاصيل المكان مزيد من المعلومات عن ضبط التنسيق ومستوى الظهور

الخصائص
hidesOnMapClick optional	النوع:  boolean optional
layoutMode optional	النوع:  PlaceDetailsLayoutMode optional
position optional	النوع:  PlaceDetailsPosition optional يتم تجاهلها عند layoutMode:INFO_WINDOW. في حال عدم تمريرها، سيتم تحديد موضع تلقائيًا استنادًا إلى layoutMode.

PlaceDetailsLayoutMode constants

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

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceDetailsLayoutMode} = await google.maps.importLibrary("localContext").
اطّلِع على المكتبات في Maps JavaScript API.

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

ثوابت PlaceDetailsPosition

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

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

تعرض هذه السمة مواضع تفاصيل المكان.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceDetailsPosition} = await google.maps.importLibrary("localContext").
اطّلِع على المكتبات في Maps JavaScript API.

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