Places Widgets

PlaceAutocompleteElement class

google.maps.places.PlaceAutocompleteElement class

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

‫PlaceAutocompleteElement هي فئة فرعية من HTMLElement تقدّم مكوّن واجهة مستخدم لواجهة برمجة التطبيقات Places Autocomplete API.

العنصر المخصّص:
<gmp-place-autocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></gmp-place-autocomplete>

يمتدّ هذا الصف إلى HTMLElement.

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

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

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

الخصائص
componentRestrictions	النوع:  ComponentRestrictions optional قيود المكوّنات تُستخدَم قيود المكوّنات لتقييد التوقّعات على تلك التي تقع ضمن المكوّن الرئيسي فقط. على سبيل المثال، البلد.
locationBias	النوع:  LocationBias optional حدود أو إشارات خفيفة لاستخدامها عند البحث عن أماكن
locationRestriction	النوع:  LocationRestriction optional الحدود التي تحدّ من نتائج البحث
name	النوع:  string optional الاسم الذي سيتم استخدامه لعنصر الإدخال. اطّلِع على https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name للاطّلاع على التفاصيل. تتّبع السلوك نفسه المُتّبع في سمة الاسم للعناصر التي يتم إدخالها. يُرجى العِلم أنّ هذا هو الاسم الذي سيتم استخدامه عند إرسال نموذج. اطّلِع على https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form للحصول على التفاصيل. سمة HTML: <gmp-placeautocomplete name="string"></gmp-placeautocomplete>
requestedLanguage	النوع:  string optional معرّف لغة للغة التي يجب عرض النتائج بها، إن أمكن قد يتم منح النتائج باللغة المحدّدة ترتيبًا أعلى، ولكن لا تقتصر الاقتراحات على هذه اللغة. اطّلِع على قائمة اللغات المتاحة. سمة HTML: <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion	النوع:  string optional رمز منطقة يُستخدَم لتنسيق النتائج وفلترة النتائج ولا تقتصر الاقتراحات على هذا البلد. يقبل رمز المنطقة قيمة نطاق المستوى الأعلى لرموز البلدان (ccTLD) المكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو uk (.co.uk) بينما رمزه وفقًا لمعيار ISO 3166-1 هو gb (للجهة المعروفة رسميًا باسم "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية"). سمة HTML: <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
types	النوع:  Array<string> optional أنواع التوقّعات التي سيتم عرضها للاطّلاع على الأنواع المتوافقة، يُرجى الاطّلاع على دليل المطوّر. في حال عدم تحديد أي أنواع، سيتم عرض جميع الأنواع. سمة HTML: <gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>

الأجزاء
prediction-item	عنصر في القائمة المنسدلة للتوقّعات يمثّل توقّعًا واحدًا
prediction-item-icon	الرمز المعروض على يمين كل عنصر في قائمة التوقّعات
prediction-item-main-text	جزء من عنصر التوقّع يمثّل النص الرئيسي للتوقّع. بالنسبة إلى المواقع الجغرافية، يحتوي هذا الحقل على اسم مكان، مثل "القاهرة"، أو اسم شارع ورقمه، مثل "10 شارع الملك". يكون لون العنصر prediction-item-main-text أسودًا تلقائيًا. إذا كان هناك أي نص إضافي في prediction-item، يكون خارج prediction-item-main-text ويرث أسلوبه من prediction-item. يكون هذا الحقل باللون الرمادي تلقائيًا. ويكون النص الإضافي عادةً عنوانًا.
prediction-item-match	الجزء من التوقّع الذي تم عرضه والذي يتطابق مع إدخال المستخدم ويتم تلقائيًا تمييز هذا النص المطابق بخط غامق. يُرجى العِلم أنّ النص المطابق قد يكون في أي مكان ضمن العنصر prediction-item. ولا يُشترط أن يكون جزءًا من prediction-item-main-text.
prediction-item-selected	العنصر الذي ينتقل إليه المستخدم باستخدام لوحة المفاتيح ملاحظة: ستتأثر العناصر المحدّدة بأنماط هذا الجزء وأنماط أجزاء عناصر التوقّعات أيضًا.
prediction-list	العنصر المرئي الذي يحتوي على قائمة التوقّعات التي تعرضها خدمة "الإكمال التلقائي للأماكن" تظهر هذه القائمة كقائمة منسدلة أسفل PlaceAutocompleteElement.

الطُرق
addEventListener	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. addEventListener(type, listener[, options]) المَعلمات:  type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه. listener:  EventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent. options:  boolean|AddEventListenerOptions optional اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive. القيمة المعروضة:  void تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
removeEventListener	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. removeEventListener(type, listener[, options]) المَعلمات:  type:  string سلسلة تحدّد نوع الحدث الذي يجب إزالة مستمع الحدث له. listener:  EventListener|EventListenerObject أداة معالجة الحدث المطلوب إزالتها من هدف الحدث options:  boolean|EventListenerOptions optional اطّلِع على الخيارات. القيمة المعروضة:  void تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener.

الفعاليات
gmp-placeselect	function(placeAutocompletePlaceSelectEvent) الوسيطات:  placeAutocompletePlaceSelectEvent:  PlaceAutocompletePlaceSelectEvent يتمّ تشغيل هذا الحدث عندما يختار أحد المستخدِمين توقّعات الأماكن. يحتوي على عنصر "مكان".
gmp-requesterror	function(placeAutocompleteRequestErrorEvent) الوسيطات:  placeAutocompleteRequestErrorEvent:  PlaceAutocompleteRequestErrorEvent يتمّ تنشيط هذا الحدث عند رفض طلب موجّه إلى الخلفية (مثل مفتاح واجهة برمجة التطبيقات غير صحيح). لا يتم تصعيد هذا الحدث.

واجهة PlaceAutocompleteElementOptions

google.maps.places.PlaceAutocompleteElementOptions واجهة

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

خيارات لإنشاء عنصر PlaceAutocompleteElement

الخصائص
componentRestrictions optional	النوع:  ComponentRestrictions optional عرض PlaceAutocompleteElement.componentRestrictions
locationBias optional	النوع:  LocationBias optional عرض PlaceAutocompleteElement.locationBias
locationRestriction optional	النوع:  LocationRestriction optional عرض PlaceAutocompleteElement.locationRestriction
requestedLanguage optional	النوع:  string optional عرض PlaceAutocompleteElement.requestedLanguage
requestedRegion optional	النوع:  string optional عرض PlaceAutocompleteElement.requestedRegion
types optional	النوع:  Array<string> optional عرض PlaceAutocompleteElement.types

فئة PlaceAutocompletePlaceSelectEvent

google.maps.places.PlaceAutocompletePlaceSelectEvent class

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

يتم إنشاء هذا الحدث بعد اختيار المستخدم مكانًا باستخدام عنصر "الإكمال التلقائي للأماكن". يمكنك الوصول إلى العنصر المحدّد باستخدام event.place.

يمتدّ هذا الصف إلى Event.

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

الخصائص
place	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. النوع:  Place

فئة PlaceAutocompleteRequestErrorEvent

google.maps.places.PlaceAutocompleteRequestErrorEvent class

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

يُطلق عنصر PlaceAutocompleteElement هذا الحدث عند حدوث مشكلة في طلب الشبكة.

يمتدّ هذا الصف إلى Event.

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

الإكمال التلقائي class

google.maps.places.Autocomplete class

تطبيق مصغّر يقدّم اقتراحات حول الأماكن استنادًا إلى النص الذي يُدخله المستخدم يتم إرفاقه بعنصر إدخال من النوع text، ويتوقّع إدخال نص في هذا الحقل. يتم عرض قائمة التوقّعات كقائمة منسدلة، ويتم تعديلها عند إدخال نص.

يمتدّ هذا الصف إلى MVCObject.

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

الشركة المصنِّعة
Autocomplete	Autocomplete(inputField[, opts]) المَعلمات:  inputField:  HTMLInputElement حقل النص <input> الذي يجب إرفاق Autocomplete به. opts:  AutocompleteOptions optional الخيارات. تنشئ مثيلًا جديدًا من Autocomplete يتم إرفاقه بحقل نص الإدخال المحدّد باستخدام الخيارات المحدّدة.

الطُرق
getBounds	getBounds() المَعلمات:  بدون القيمة المعروضة:  LatLngBounds|undefined الحدود المؤثرة. تعرِض الحدود التي تكون التوقّعات متحيّزة لها.
getFields	getFields() المَعلمات:  بدون القيمة المعروضة:  Array<string>|undefined تعرِض الحقول التي يجب تضمينها للمكان في استجابة التفاصيل عند استرداد التفاصيل بنجاح. للحصول على قائمة بالحقول، اطّلِع على PlaceResult.
getPlace	getPlace() المَعلمات:  بدون القيمة المعروضة:  PlaceResult المكان الذي اختاره المستخدم. تعرِض هذه السمة تفاصيل المكان الذي اختاره المستخدم في حال تم استرداد التفاصيل بنجاح. بخلاف ذلك، يتم عرض عنصر "مكان" أساسي، مع ضبط السمة name على القيمة الحالية لحقل الإدخال.
setBounds	setBounds(bounds) المَعلمات:  bounds:  LatLngBounds|LatLngBoundsLiteral optional حدود التحيز. القيمة المعروضة:  لا شيء لضبط المنطقة المفضّلة التي يتم عرض نتائج "الأماكن" فيها وتتضمّن النتائج معلومات عن هذه المنطقة، ولكن ليس فقط.
setComponentRestrictions	setComponentRestrictions(restrictions) المَعلمات:  restrictions:  ComponentRestrictions optional القيود المفروضة على الاستخدام القيمة المعروضة:  لا شيء تُستخدَم لضبط قيود المكوّنات. تُستخدَم قيود المكوّنات لتقييد التوقّعات على تلك التي تقع ضمن المكوّن الرئيسي فقط. على سبيل المثال، البلد.
setFields	setFields(fields) المَعلمات:  fields:  Array<string> optional القيمة المعروضة:  لا شيء تُستخدَم لضبط الحقول التي سيتم تضمينها للمكان في استجابة التفاصيل عند استرداد التفاصيل بنجاح. للحصول على قائمة بالحقول، اطّلِع على PlaceResult.
setOptions	setOptions(options) المَعلمات:  options:  AutocompleteOptions optional القيمة المعروضة:  لا شيء
setTypes	setTypes(types) المَعلمات:  types:  Array<string> optional أنواع التوقّعات المطلوب تضمينها القيمة المعروضة:  لا شيء لضبط أنواع التوقّعات التي سيتم عرضها. للاطّلاع على الأنواع المتوافقة، يُرجى الاطّلاع على دليل المطوّر. في حال عدم تحديد أي أنواع، سيتم عرض جميع الأنواع.
مُكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

الفعاليات
place_changed	function() الوسيطات:  بدون يتم تشغيل هذا الحدث عند إتاحة PlaceResult لمكان اختاره المستخدم. إذا أدخل المستخدم اسم مكان لم يقترحه عنصر التحكّم وضغط على مفتاح Enter، أو إذا تعذّر طلب تفاصيل المكان، يحتوي PlaceResult على إدخال المستخدم في السمة name، بدون تحديد أي سمات أخرى.

واجهة AutocompleteOptions

google.maps.places.AutocompleteOptions واجهة

الخيارات التي يمكن ضبطها على عنصر Autocomplete

الخصائص
bounds optional	النوع:  LatLngBounds|LatLngBoundsLiteral optional المنطقة التي تريد البحث فيها عن أماكن
componentRestrictions optional	النوع:  ComponentRestrictions optional قيود المكوّنات تُستخدَم قيود المكوّنات لتقييد التوقّعات على تلك التي تقع ضمن المكوّن الرئيسي فقط. على سبيل المثال، البلد.
fields optional	النوع:  Array<string> optional الحقول التي يجب تضمينها للمكان في استجابة التفاصيل عند استرداد التفاصيل بنجاح، والتي سيتم تحصيل رسومها في حال تمّ إدخال ['ALL']، سيتمّ عرض جميع الحقول المتاحة وسيتمّ تحصيل رسوم مقابلها (لا يُنصح بذلك في عمليات النشر في مرحلة الإنتاج). للحصول على قائمة بالحقول، اطّلِع على PlaceResult. يمكن تحديد الحقول المُدمجة باستخدام مسارات النقاط (مثلاً، "geometry.location"). القيمة التلقائية هي ['ALL'].
placeIdOnly optional	ميزة متوقّفة نهائيًا: تم إيقاف placeIdOnly نهائيًا اعتبارًا من 15 كانون الثاني (يناير) 2019، وسيتم إيقافها نهائيًا في 15 كانون الثاني (يناير) 2020. استخدِم AutocompleteOptions.fields بدلاً من ذلك: fields: ['place_id', 'name', 'types']. النوع:  boolean optional ما إذا كان سيتم استرداد معرّفات الأماكن فقط لن يتضمّن عنصر PlaceResult الذي يتوفّر عند بدء حدث place_changed سوى حقلَي place_id وtypes وname، مع عرض حقلَي place_id وtypes وdescription من خلال خدمة الإكمال التلقائي. يكون هذا الخيار غير مفعّل تلقائيًا.
strictBounds optional	النوع:  boolean optional قيمة منطقية تشير إلى أنّ التطبيق المصغّر للإكمال التلقائي يجب أن يعرض فقط الأماكن التي تقع داخل حدود التطبيق المصغّر للإكمال التلقائي في وقت إرسال الطلب. سيؤدي ضبط strictBounds على false (وهو الإعداد التلقائي) إلى توجيه النتائج نحو الأماكن ضمن الحدود، ولكن ليس فقط.
types optional	النوع:  Array<string> optional أنواع التوقّعات التي سيتم عرضها للاطّلاع على الأنواع المتوافقة، يُرجى الاطّلاع على دليل المطوّر. في حال عدم تحديد أي أنواع، سيتم عرض جميع الأنواع.

فئة SearchBox

google.maps.places.SearchBox class

تطبيق مصغّر يقدّم اقتراحات لطلبات البحث استنادًا إلى النص الذي يُدخله المستخدم يتم إرفاقه بعنصر إدخال من النوع text، ويتوقّع إدخال نص في هذا الحقل. يتم عرض قائمة التوقّعات كقائمة منسدلة، ويتم تعديلها عند إدخال نص.

يمتدّ هذا الصف إلى MVCObject.

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

الشركة المصنِّعة
SearchBox	SearchBox(inputField[, opts]) المَعلمات:  inputField:  HTMLInputElement opts:  SearchBoxOptions optional تنشئ مثيلًا جديدًا من SearchBox يتم إرفاقه بحقل نص الإدخال المحدّد باستخدام الخيارات المحدّدة.

الطُرق
getBounds	getBounds() المَعلمات:  بدون القيمة المعروضة:  LatLngBounds|undefined تعرِض الحدود التي تكون فيها توقعات طلبات البحث متحيّزة.
getPlaces	getPlaces() المَعلمات:  بدون القيمة المعروضة:  Array<PlaceResult>|undefined تعرِض هذه السمة طلب البحث الذي اختاره المستخدِم لاستخدامه مع الحدث places_changed.
setBounds	setBounds(bounds) المَعلمات:  bounds:  LatLngBounds|LatLngBoundsLiteral optional القيمة المعروضة:  لا شيء لضبط المنطقة التي سيتم استخدامها لتحديد توقّعات طلبات البحث التي تتضمّن تحيزًا. وستتضمّن النتائج معلومات عن هذه المنطقة فقط ولن تقتصر عليها بالكامل.
مُكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

الفعاليات
places_changed	function() الوسيطات:  بدون يتم تشغيل هذا الحدث عندما يختار المستخدم طلب بحث، ويجب استخدام getPlaces للحصول على أماكن جديدة.

SearchBoxOptions واجهة

google.maps.places.SearchBoxOptions واجهة

الخيارات التي يمكن ضبطها على عنصر SearchBox

الخصائص
bounds optional	النوع:  LatLngBounds|LatLngBoundsLiteral optional المنطقة التي يجب توجيه توقّعات طلبات البحث نحوها وتتّجه التوقّعات نحو طلبات البحث التي تستهدِف هذه الحدود، ولكن ليس فقط.