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
|
الطُرق | |
---|---|
|
addEventListener(type, listener[, options]) المَعلمات:
قيمة الإرجاع:
void إعداد دالة سيتم طلبها عند تسليم الحدث المحدد إلى الهدف. راجِع addEventListener |
|
removeEventListener(type, listener[, options]) المَعلمات:
قيمة الإرجاع:
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 للخرائط.
أماكن إقامة | |
---|---|
|
النوع:
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) المَعلمات:
قيمة العرض: لا شيء
تحدد الحقول التي سيتم تضمينها في المكان في استجابة التفاصيل عندما يتم استرداد التفاصيل بنجاح. للاطّلاع على قائمة بالحقول، يُرجى مراجعة PlaceResult . |
setOptions |
setOptions(options) المَعلمات:
قيمة العرض: لا شيء
|
setTypes |
setTypes(types) المَعلمات:
قيمة العرض: لا شيء
تحدِّد أنواع عبارات البحث المقترحة التي سيتم عرضها. لمعرفة الأنواع المتوافقة، يُرجى الاطّلاع على دليل المطوِّر. إذا لم يتمّ تحديد أيّ أنواع، سيتمّ عرض جميع الأنواع. |
مكتسَب:
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'] . |
|
النوع:
boolean optional ما إذا كان سيتم استرداد أرقام تعريف الأماكن فقط. ستحتوي نتيجة العنصر التي يتم توفيرها عند تنشيط الحدثplace_changed فقط على حقولplace_id والأنواع والاسم، إلى جانبplace_id والأنواع والوصف الذي تعرضه خدمة الإكمال التلقائي. يكون هذا الإعداد غير مفعَّل تلقائيًا. |
strictBounds optional |
النوع:
boolean optional قيمة منطقية تشير إلى أنّ تطبيق الإكمال التلقائي المصغّر يجب أن يعرض فقط الأماكن التي كانت ضمن حدود أداة الإكمال التلقائي عند إرسال طلب البحث. وعند ضبط شِرْكِةِ قِيمِيَّة لِـ false (وَهْيَ الْإِعْدَادِ التِّلْقَائِي)، سَيَتِمّْ مَنْحِيَةُ النَّتَائِجْ، عَلَيْهَا، تَحْدِيدْ الْأَمَاكِنِ الْخَاصَّة بِمَوَاقِعِ الْحَدِّ الْأَقْصَى. |
types optional |
النوع:
Array<string> optional أنواع عبارات البحث المقترحة التي سيتم عرضها لمعرفة الأنواع المتوافقة، يُرجى الاطّلاع على دليل المطوِّر. إذا لم يتمّ تحديد أيّ أنواع، سيتمّ عرض جميع الأنواع. |
فئة SearchBox
صف واحد (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 المنطقة التي يمكن تحيز توقعات طلب البحث نحوها. تكون التوقعات منحازة نحو طلبات البحث التي تستهدف هذه الحدود، على سبيل المثال لا الحصر. |