Places Widgets

فئة PlaceAutocompleteElement

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

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

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

يمكنك الوصول من خلال الاتصال بـ const {PlaceAutocompleteElement} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند رفض طلب في الخلفية (على سبيل المثال، مفتاح واجهة برمجة التطبيقات غير صحيح). هذا الحدث ليس فقاعة محادثة.

واجهة PlaceأولElementElement

واجهة 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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)
المعلّمات: 
  • types:  Array<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
ما إذا كان سيتم استرداد أرقام تعريف الأماكن فقط. إنّ المكان الذي توفّره نتيجة البحث عن المكان الذي تم تنشيطه عند تنشيط event_change سيتضمّن فقط حقول Place_id والأنواع والأسماء، مع إبراز Place_id والأنواع والوصف من خلال خدمة "الإكمال التلقائي". يكون هذا الإعداد غير مفعَّل بشكل تلقائي.
strictBounds optional
النوع:  boolean optional
قيمة منطقية، تشير إلى أنّ أداة "الإكمال التلقائي" يجب أن تعرض فقط الأماكن التي تكون داخل حدود أداة "الإكمال التلقائي" في وقت إرسال طلب البحث. عند ضبط strictBounds على 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
تمثّل هذه السمة المنطقة التي سيتم انحيازها لطلبات البحث المقترَحة. يتم انحياز التوقعات - على سبيل المثال لا الحصر - طلبات البحث التي تستهدف هذه الحدود.