Places Widgets

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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)
المعلّمات:
  • fields: Array<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، بدون تحديد خصائص أخرى.

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'].
placeIdOnly optional
النوع: boolean optional
ما إذا كان سيتم استرداد معرفات الأماكن فقط أم لا. ستتضمن نتيجة المكان التي تمت إتاحتها عند تنشيط حدث "ما تغيّر المكان" فقط خاصية المكان ، والأنواع وحقول الاسم، مع عرض معرّف المكان والأنواع والوصف من خلال خدمة الإكمال التلقائي. تم الإيقاف تلقائيًا.
strictBounds optional
النوع: boolean optional
قيمة منطقية تشير إلى أن أداة الإكمال التلقائي يجب أن تعرض الأماكن الموجودة داخل حدود أداة الإكمال التلقائي فقط في وقت إرسال طلب البحث. يؤدي ضبط strictBounds على false (وهو الخيار التلقائي) إلى انحياز النتائج في الأماكن المضمّنة في الحدود، على سبيل المثال لا الحصر.
types optional
النوع: Array<string> optional
أنواع التوقعات التي سيتم عرضها. لمعرفة الأنواع المتاحة، يُرجى الاطّلاع على دليل المطوِّر. إذا لم يتم تحديد أي أنواع، سيتم عرض جميع الأنواع.

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
المنطقة التي يتم الانحياز إليها في توقعات طلب البحث. تكون التنبؤات منحازة لطلبات البحث التي تستهدف هذه الحدود، على سبيل المثال لا الحصر.