Places Widgets

فئة PlaceCompleteElement

google.maps.places.PlaceAutocompleteElement الصف الدراسي

تنفيذ الإكمال التلقائي لواجهة برمجة تطبيقات الأماكن

ينفِّذ هذا الصف PlaceAutocompleteElementOptions.

الوصول من خلال الاتصال بـ const {PlaceAutocompleteElement} = await google.maps.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
المعلّمات: 
element optional
النوع:  HTMLElement|SVGElement optional
هذا الحقل للقراءة فقط. عنصر DOM الذي يدعم العرض.
inputElement
النوع:  HTMLInputElement
عنصر الإدخال لعرض عمليات الإكمال التلقائي.
موروثة: componentRestrictions، locationBias، locationRestriction، requestedLanguage، requestedRegion، types
addListener
addListener(eventName, handler)
المعلّمات: 
  • eventName:  string
  • handler:  Function
قيمة الإرجاع:  MapsEventListener
لإضافة وظيفة المستمع المحددة إلى اسم الحدث المحدد.
gmp-placeselect
function(place)
الوسيطات: 
يتم تشغيل هذا الحدث عندما يحدد أحد المستخدمين توقعًا للمكان. لعرض كائن مكان
gmp-requesterror
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند رفض طلب الخلفية (على سبيل المثال، مفتاح واجهة برمجة تطبيقات غير صحيح). لا فقاعة تفسيرية لهذا الحدث.

PlaceCompleteElementOptions واجهة

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

خيارات إنشاء العنصر الإكمال التلقائي.
inputElement
النوع:  HTMLInputElement
عنصر الإدخال لعرض عمليات الإكمال التلقائي.
componentRestrictions optional
النوع:  ComponentRestrictions optional
قيود المكوّن. يتم استخدام قيود المكوّنات لحصر التوقّعات على المستخدمين داخل المكوّن الأصلي فقط. البلد مثلاً.
element optional
النوع:  HTMLElement|SVGElement optional
هذا الحقل للقراءة فقط. عنصر DOM الذي يدعم العرض.
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
أنواع التوقعات التي سيتم عرضها. لمعرفة الأنواع المتاحة، يُرجى الاطّلاع على دليل المطوِّر. إذا لم يتم تحديد أي أنواع، سيتم عرض جميع الأنواع.

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

google.maps.places.Autocomplete الصف الدراسي

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

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

الوصول من خلال الاتصال بـ const {Autocomplete} = await google.maps.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)
المعلّمات: 
  • restrictions:  ComponentRestrictions optional القيود المفروضة على الاستخدام.
قيمة الإرجاع: بدون
لتعيين قيود المكونات. يتم استخدام قيود المكوّنات لحصر التوقّعات على المستخدمين داخل المكوّن الأصلي فقط. البلد مثلاً.
setFields
setFields(fields)
المعلّمات: 
  • fields:  Array<string> optional
قيمة الإرجاع: بدون
لتعيين الحقول التي سيتم تضمينها للمكان في استجابة التفاصيل عند استرداد التفاصيل بنجاح. للحصول على قائمة بالحقول، راجع PlaceResult.
setOptions
setOptions(options)
المعلّمات: 
قيمة الإرجاع: بدون
setTypes
setTypes(types)
المعلّمات: 
  • types:  Array<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.

الوصول من خلال الاتصال بـ const {SearchBox} = await google.maps.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
المنطقة التي يتم الانحياز إليها في توقعات طلب البحث. تكون التنبؤات منحازة لطلبات البحث التي تستهدف هذه الحدود، على سبيل المثال لا الحصر.