الإكمال التلقائي في الصف
google.maps.places.Autocomplete
الصف الدراسي
أداة تقدم توقعات الأماكن بناءً على إدخال النص للمستخدم. ويتم إلحاقه بعنصر إدخال من النوع text
ويستمع إلى إدخال النص في هذا الحقل. يتم عرض قائمة التوقعات كقائمة منسدلة، ويتم تحديثها عند إدخال النص.
يمتد هذا الصف
MVCObject
.
تحميل باستخدام معلمة عنوان URL &libraries=places
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {Autocomplete} = await google.map.importLibrary("places")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الشركة المصنِّعة | |
---|---|
Autocomplete |
Autocomplete(inputField[, opts]) المعلّمات:
لإنشاء مثيل جديد من Autocomplete يتم إلحاقه بحقل إدخال النص المحدد باستخدام الخيارات المحددة. |
الطُرق | |
---|---|
getBounds |
getBounds() المعلّمات: بدون
قيمة العرض:
LatLngBounds|undefined حدود الانحياز.لعرض الحدود التي تظهر عليها انحيازات. |
getFields |
getFields() المعلّمات: بدون
قيمة الإرجاع:
Array<string>|undefined لعرض الحقول التي سيتم تضمينها للمكان في استجابة التفاصيل عند استرداد التفاصيل بنجاح. للحصول على قائمة بالحقول، راجع PlaceResult . |
getPlace |
getPlace() المعلّمات: بدون
قيمة العرض:
PlaceResult المكان الذي اختاره المستخدم.لعرض تفاصيل المكان الذي حدده المستخدم إذا تم استرداد التفاصيل بنجاح. وبخلاف ذلك، يتم إرجاع كائن مكان بديل، مع ضبط الخاصية 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 ، بدون تحديد خصائص أخرى. |
completionOptions واجهة
واجهة
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 ما إذا كان سيتم استرداد معرفات الأماكن فقط أم لا. ستتضمن نتيجة المكان التي تمت إتاحتها عند تنشيط حدث "ما تغيّر المكان" فقط خاصية المكان ، والأنواع وحقول الاسم، مع عرض معرّف المكان والأنواع والوصف من خلال خدمة الإكمال التلقائي. تم الإيقاف تلقائيًا. |
strictBounds optional |
النوع:
boolean optional قيمة منطقية تشير إلى أن أداة الإكمال التلقائي يجب أن تعرض الأماكن الموجودة داخل حدود أداة الإكمال التلقائي فقط في وقت إرسال طلب البحث. يؤدي ضبط strictBounds على false (وهو الخيار التلقائي) إلى انحياز النتائج في الأماكن المضمّنة في الحدود، على سبيل المثال لا الحصر. |
types optional |
النوع:
Array<string> optional أنواع التوقعات التي سيتم عرضها. لمعرفة الأنواع المتاحة، يُرجى الاطّلاع على دليل المطوِّر. إذا لم يتم تحديد أي أنواع، سيتم عرض جميع الأنواع. |
SearchBox
google.maps.places.SearchBox
الصف الدراسي
أداة تقدم توقعات طلبات البحث استنادًا إلى إدخال نص المستخدم. ويتم إلحاقه بعنصر إدخال من النوع text
ويستمع إلى إدخال النص في هذا الحقل. يتم عرض قائمة التوقعات كقائمة منسدلة، ويتم تحديثها عند إدخال النص.
يمتد هذا الصف
MVCObject
.
تحميل باستخدام معلمة عنوان URL &libraries=places
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {SearchBox} = await google.map.importLibrary("places")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الشركة المصنِّعة | |
---|---|
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 المنطقة التي يتم الانحياز إليها في توقعات طلب البحث. تكون التنبؤات منحازة لطلبات البحث التي تستهدف هذه الحدود، على سبيل المثال لا الحصر. |