Places Widgets

PlaceAutocompleteElement فئة

صف واحد (google.maps.places.PlaceAutocompleteElement)

  • PlusAutocompleteElement هي فئة فرعية HTMLElement توفر مكونًا لواجهة المستخدم لواجهة برمجة تطبيقات الإكمال التلقائي للأماكن. بعد تحميل مكتبة places، يمكن إنشاء إدخال بوظيفة الإكمال التلقائي في HTML. على سبيل المثال:
    <gmp-placeautocomplete ></gmp-placeautocomplete>

عنصر مخصّص:
<gmp-placeautocomplete></gmp-placeautocomplete>

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

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

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

PlaceAutocompleteElement
PlaceAutocompleteElement(options)
المَعلمات: 
inputElement
النوع:  HTMLInputElement
عنصر الإدخال لعرض عمليات الإكمال التلقائي
مكتسَب: componentRestrictions، locationBias، locationRestriction، requestedLanguage، requestedRegion، types
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة حساسة لحالة الأحرف تمثل نوع الحدث الذي تريد الاستماع إليه.
  • listenerEventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا يجب أن يكون هذا دالة أو كائنًا باستخدام طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional اطّلِع على الخيارات. تتوافق الأحداث المخصّصة مع capture وpassive فقط.
قيمة الإرجاع:  void
إعداد دالة سيتم طلبها عند تسليم الحدث المحدد إلى الهدف. راجِع addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدِّد نوع الحدث المطلوب إزالة أداة معالجة الحدث
  • listenerEventListener|EventListenerObject أداة معالجة الحدث لمعالج الحدث المطلوب إزالتها من هدف الحدث.
  • optionsboolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة الإرجاع:  void
تتم إزالة أداة معالجة حدث تم تسجيلها سابقًا باستخدام addEvent Listener من الهدف. راجِع removeEventListener

واجهة PlaceAutocompleteElementOptions

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

خيارات إنشاءPlaceAutocompleteElement

inputElement
النوع:  HTMLInputElement
عنصر الإدخال لعرض عمليات الإكمال التلقائي
componentRestrictions optional
النوع:  ComponentRestrictions optional
قيود المكوّنات. تُستخدَم قيود المكونات لحصر عبارات البحث المقترحة في المكوِّن الرئيسي فقط. على سبيل المثال، البلد.
locationBias optional
النوع:  LocationBias optional
حدود خفيفة أو تلميح للاستخدام عند البحث عن أماكن.
locationRestriction optional
النوع:  LocationRestriction optional
قيود على نتائج البحث.
requestedLanguage optional
النوع:  string optional
معرّف اللغة الذي يجب عرض النتائج به، إن أمكن. قد يتم إعطاء النتائج في اللغة المحددة ترتيبًا أعلى، لكن الاقتراحات لا تقتصر على هذه اللغة. اطّلِع على قائمة اللغات المتاحة.
requestedRegion optional
النوع:  string optional
رمز منطقة يُستخدم لتنسيق النتائج وفلترة النتائج. ولا يؤدي ذلك إلى حصر الاقتراحات بهذا البلد. يقبل رمز المنطقة قيمة مؤلفة من حرفين من حرفَين ccTLD ("نطاق المستوى الأعلى"). تتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات الملحوظة. على سبيل المثال، يكون نطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD) في المملكة المتحدة هو "uk" (.co.uk)، في حين يكون رمز ISO 3166-1 هو "gb" (من الناحية الفنية لجهة "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
types optional
النوع:  Array<string> optional
أنواع عبارات البحث المقترحة التي سيتم عرضها لمعرفة الأنواع المتوافقة، يُرجى الاطّلاع على دليل المطوِّر. إذا لم يتمّ تحديد أيّ أنواع، سيتمّ عرض جميع الأنواع.

PlaceAutocompletePlaceSelectEvent فئة

صف واحد (google.maps.places.PlaceAutocompletePlaceSelectEvent)

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

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

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

Alphaplace
النوع:  Place

PlaceAutocompleteRequestErrorEvent فئة

صف واحد (google.maps.places.PlaceAutocompleteRequestErrorEvent)

يتم إرسال هذا الحدث من خلال المكانPlaceAutocompleteElement عندما تكون هناك مشكلة في طلب الشبكة.

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

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

صف الإكمال التلقائي

صف واحد (google.maps.places.Autocomplete)

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

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

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

Autocomplete
Autocomplete(inputField[, opts])
المَعلمات: 
تنشئ هذه الدالة مثيلاً جديدًا من Autocomplete يتم إرفاقه بحقل إدخال النص المحدد باستخدام الخيارات المحددة.
getBounds
getBounds()
المَعلمات: لا شيء
قيمة العرض:  LatLngBounds|undefined حدود الانحياز.
لعرض الحدود المتحيزة للتوقعات.
getFields
getFields()
المَعلمات: لا شيء
قيمة الإرجاع:  Array<string>|undefined
تؤدي إلى إرجاع الحقول التي سيتم تضمينها في المكان في استجابة التفاصيل عندما يتم استرداد التفاصيل بنجاح. للاطّلاع على قائمة بالحقول، يُرجى مراجعة PlaceResult.
getPlace
getPlace()
المَعلمات: لا شيء
قيمة العرض:  PlaceResult المكان الذي اختاره المستخدم.
تُرجع تفاصيل المكان الذي اختاره المستخدم إذا تم استرداد التفاصيل بنجاح. وبخلاف ذلك، يتم عرض كائن وضع stub، مع ضبط السمة name على القيمة الحالية لحقل الإدخال.
setBounds
setBounds(bounds)
المَعلمات: 
قيمة العرض: لا شيء
لتعيين المنطقة المفضلة التي سيتم من خلالها عرض نتائج المكان. تكون النتائج منحازة، على سبيل المثال لا الحصر، هذه المنطقة.
setComponentRestrictions
setComponentRestrictions(restrictions)
المَعلمات: 
قيمة العرض: لا شيء
تحدِّد هذه السياسة القيود المفروضة على المكوِّن. تُستخدَم قيود المكونات لحصر عبارات البحث المقترحة في المكوِّن الرئيسي فقط. على سبيل المثال، البلد.
setFields
setFields(fields)
المَعلمات: 
  • fieldsArray<string> optional
قيمة العرض: لا شيء
تحدد الحقول التي سيتم تضمينها في المكان في استجابة التفاصيل عندما يتم استرداد التفاصيل بنجاح. للاطّلاع على قائمة بالحقول، يُرجى مراجعة PlaceResult.
setOptions
setOptions(options)
المَعلمات: 
قيمة العرض: لا شيء
setTypes
setTypes(types)
المَعلمات: 
  • typesArray<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
النوع:  boolean optional
ما إذا كان سيتم استرداد أرقام تعريف الأماكن فقط. ستحتوي نتيجة العنصر التي يتم توفيرها عند تنشيط الحدثplace_changed فقط على حقولplace_id والأنواع والاسم، إلى جانبplace_id والأنواع والوصف الذي تعرضه خدمة الإكمال التلقائي. يكون هذا الإعداد غير مفعَّل تلقائيًا.
strictBounds optional
النوع:  boolean optional
قيمة منطقية تشير إلى أنّ تطبيق الإكمال التلقائي المصغّر يجب أن يعرض فقط الأماكن التي كانت ضمن حدود أداة الإكمال التلقائي عند إرسال طلب البحث. وعند ضبط شِرْكِةِ قِيمِيَّة لِـ false (وَهْيَ الْإِعْدَادِ التِّلْقَائِي)، سَيَتِمّْ مَنْحِيَةُ النَّتَائِجْ، عَلَيْهَا، تَحْدِيدْ الْأَمَاكِنِ الْخَاصَّة بِمَوَاقِعِ الْحَدِّ الْأَقْصَى.
types optional
النوع:  Array<string> optional
أنواع عبارات البحث المقترحة التي سيتم عرضها لمعرفة الأنواع المتوافقة، يُرجى الاطّلاع على دليل المطوِّر. إذا لم يتمّ تحديد أيّ أنواع، سيتمّ عرض جميع الأنواع.

صف واحد (google.maps.places.SearchBox)

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

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

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

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

واجهة SearchBoxOptions

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

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

bounds optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
المنطقة التي يمكن تحيز توقعات طلب البحث نحوها. تكون التوقعات منحازة نحو طلبات البحث التي تستهدف هذه الحدود، على سبيل المثال لا الحصر.