Places Widgets

PlaceAutocompleteElement class

google.maps.places.PlaceAutocompleteElement class

‫PlaceAutocompleteElement هي فئة فرعية من HTMLElement تقدّم مكوّن واجهة مستخدم لواجهة برمجة التطبيقات Places Autocomplete API.

العنصر المخصّص:
<gmp-place-autocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></gmp-place-autocomplete>

يمتدّ هذا الصف إلى HTMLElement.

تنفّذ هذه الفئة PlaceAutocompleteElementOptions.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceAutocompleteElement} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
المَعلمات: 
componentRestrictions
النوع:  ComponentRestrictions optional
قيود المكوّنات تُستخدَم قيود المكوّنات لتقييد التوقّعات على تلك التي تقع ضمن المكوّن الرئيسي فقط. على سبيل المثال، البلد.
locationBias
النوع:  LocationBias optional
حدود غير واضحة أو تلميح لاستخدامه عند البحث عن أماكن
locationRestriction
النوع:  LocationRestriction optional
الحدود التي تحدّ من نتائج البحث
name
النوع:  string optional
الاسم الذي سيتم استخدامه لعنصر الإدخال. اطّلِع على https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name للاطّلاع على التفاصيل. تتّبع السلوك نفسه المُتّبع في سمة الاسم للعناصر التي يتم إدخالها. يُرجى العِلم أنّ هذا هو الاسم الذي سيتم استخدامه عند إرسال نموذج. اطّلِع على https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form للحصول على التفاصيل.
سمة HTML:
  • <gmp-placeautocomplete name="string"></gmp-placeautocomplete>
requestedLanguage
النوع:  string optional
معرّف لغة للغة التي يجب عرض النتائج بها، إن أمكن قد يتم منح النتائج باللغة المحدّدة ترتيبًا أعلى، ولكن لا تقتصر الاقتراحات على هذه اللغة. اطّلِع على قائمة اللغات المتاحة.
سمة HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
النوع:  string optional
رمز منطقة يُستخدَم لتنسيق النتائج وفلترة النتائج ولا تقتصر الاقتراحات على هذا البلد. يقبل رمز المنطقة قيمة نطاق المستوى الأعلى لرموز البلدان (ccTLD) المكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو uk (.co.uk) بينما رمزه وفقًا لمعيار ISO 3166-1 هو gb (للجهة المعروفة رسميًا باسم "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
سمة HTML:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
types
النوع:  Array<string> optional
أنواع التوقّعات التي سيتم عرضها للاطّلاع على الأنواع المتوافقة، يُرجى الاطّلاع على دليل المطوّر. في حال عدم تحديد أي أنواع، سيتم عرض جميع الأنواع.
سمة HTML:
  • <gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>
prediction-item
عنصر في القائمة المنسدلة للتوقّعات يمثّل توقّعًا واحدًا
prediction-item-icon
الرمز المعروض على يمين كل عنصر في قائمة التوقّعات
prediction-item-main-text
جزء من عنصر التوقّع يمثّل النص الرئيسي للتوقّع. بالنسبة إلى المواقع الجغرافية، يحتوي هذا الحقل على اسم مكان، مثل "القاهرة"، أو اسم شارع ورقمه، مثل "10 شارع الملك". يكون لون العنصر prediction-item-main-text أسودًا تلقائيًا. إذا كان هناك أي نص إضافي في prediction-item، يكون خارج prediction-item-main-text ويرث أسلوبه من prediction-item. يكون هذا الحقل باللون الرمادي تلقائيًا. ويكون النص الإضافي عادةً عنوانًا.
prediction-item-match
الجزء من التوقّع الذي تم عرضه والذي يتطابق مع إدخال المستخدم ويتم تلقائيًا تمييز هذا النص المطابق بخط غامق. يُرجى العِلم أنّ النص المطابق قد يكون في أي مكان ضمن العنصر prediction-item. ولا يُشترط أن يكون جزءًا من prediction-item-main-text.
prediction-item-selected
العنصر الذي ينتقل إليه المستخدم باستخدام لوحة المفاتيح ملاحظة: ستتأثر العناصر المحدّدة بأنماط هذا الجزء وأنماط أجزاء عناصر التوقّعات أيضًا.
prediction-list
العنصر المرئي الذي يحتوي على قائمة التوقّعات التي تعرضها خدمة "الإكمال التلقائي للأماكن" تظهر هذه القائمة كقائمة منسدلة أسفل PlaceAutocompleteElement.
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه.
  • listener:  EventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent.
  • options:  boolean|AddEventListenerOptions optional اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
القيمة المعروضة:  void
تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener.
gmp-placeselect
function(placeAutocompletePlaceSelectEvent)
الوسيطات: 
يتمّ تشغيل هذا الحدث عندما يختار أحد المستخدِمين توقّعات الأماكن. يحتوي على عنصر "مكان".
gmp-requesterror
function(placeAutocompleteRequestErrorEvent)
الوسيطات: 
يتمّ تنشيط هذا الحدث عند رفض طلب موجّه إلى الخلفية (مثل مفتاح واجهة برمجة التطبيقات غير صحيح). لا يتم تصعيد هذا الحدث.

واجهة PlaceAutocompleteElementOptions

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

خيارات لإنشاء عنصر PlaceAutocompleteElement
componentRestrictions optional
النوع:  ComponentRestrictions optional
عرض PlaceAutocompleteElement.componentRestrictions
locationBias optional
النوع:  LocationBias optional
عرض PlaceAutocompleteElement.locationBias
locationRestriction optional
النوع:  LocationRestriction optional
عرض PlaceAutocompleteElement.locationRestriction
requestedLanguage optional
النوع:  string optional
عرض PlaceAutocompleteElement.requestedLanguage
requestedRegion optional
النوع:  string optional
عرض PlaceAutocompleteElement.requestedRegion
types optional
النوع:  Array<string> optional
عرض PlaceAutocompleteElement.types

فئة PlaceAutocompletePlaceSelectEvent

google.maps.places.PlaceAutocompletePlaceSelectEvent class

يتم إنشاء هذا الحدث بعد اختيار المستخدم مكانًا باستخدام عنصر "الإكمال التلقائي للأماكن". يمكنك الوصول إلى العنصر المحدّد باستخدام event.place.

يمتدّ هذا الصف إلى Event.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
Betaplace
النوع:  Place

فئة PlaceAutocompleteRequestErrorEvent

google.maps.places.PlaceAutocompleteRequestErrorEvent class

يُطلق عنصر PlaceAutocompleteElement هذا الحدث عند حدوث مشكلة في طلب الشبكة.

يمتدّ هذا الصف إلى Event.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

فئة PlaceDetailsElement

google.maps.places.PlaceDetailsElement class

عنصر HTML يعرض تفاصيل مكان استخدِم الطريقتَين configureFromPlace() أو configureFromLocation() لتحديد المحتوى الذي سيتم عرضه. لاستخدام عنصر "تفاصيل المكان"، فعِّل Places UI Kit API لمشروعك في وحدة تحكّم Google Cloud.

العنصر المخصّص:
<gmp-place-details size="small"></gmp-place-details>

يمتدّ هذا الصف إلى HTMLElement.

تنفّذ هذه الفئة PlaceDetailsElementOptions.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceDetailsElement} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
PlaceDetailsElement
PlaceDetailsElement([options])
المَعلمات: 
place
النوع:  Place optional
للقراءة فقط. Place عنصر يحتوي على رقم التعريف والموقع الجغرافي ومساحة العرض للمكان المعروض حاليًا
size
النوع:  PlaceDetailsSize optional
سمة المقاس في عنصر PlaceDetailsElement سيعرض العنصر PlaceDetailsSize.X_LARGE تلقائيًا.
سمة HTML:
  • <gmp-place-details size="small"></gmp-place-details>
  • <gmp-place-details size="medium"></gmp-place-details>
  • <gmp-place-details size="large"></gmp-place-details>
  • <gmp-place-details size="x-large"></gmp-place-details>
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه.
  • listener:  EventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent.
  • options:  boolean|AddEventListenerOptions optional اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
configureFromLocation
configureFromLocation(location)
المَعلمات: 
  • ‫location:  LatLng|LatLngLiteral الموقع الجغرافي الذي يتم عرض تفاصيل المكان له
القيمة المعروضة:  Promise<void> وعد يتم حلّه بعد تحميل بيانات المكان وعرضها.
ضبط التطبيق المصغّر من LatLng باستخدام ميزة عكس الترميز الجغرافي
configureFromPlace
configureFromPlace(place)
المَعلمات: 
  • place:  Place|{id:string} المكان الذي يتم عرض التفاصيل له.
القيمة المعروضة:  Promise<void> وعد يتم حلّه بعد تحميل بيانات المكان وعرضها.
لضبط التطبيق المصغّر من كائن Place أو رقم تعريف مكان
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
القيمة المعروضة:  void
تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener.
gmp-load
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تحميل العنصر وعرض محتواه. لا يتم تجميع هذا الحدث.
gmp-requesterror
function(event)
الوسيطات: 
يتمّ تنشيط هذا الحدث عند رفض طلب موجّه إلى الخلفية (مثل مفتاح واجهة برمجة التطبيقات غير صحيح). لا يتم تصعيد هذا الحدث.

واجهة PlaceDetailsElementOptions

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

خيارات PlaceDetailsElement
size optional
النوع:  PlaceDetailsSize optional
عرض PlaceDetailsElement.size

PlaceDetailsSize الثوابت

google.maps.places.PlaceDetailsSize الثوابت

خيارات المقاس لـ PlaceDetailsElement

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceDetailsSize} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
LARGE السعر المتغير الكبير الذي يتضمّن صورة كبيرة ومعلومات أساسية ومعلومات الاتصال
MEDIUM السعر المتغير المتوسط الذي يتضمّن صورة كبيرة ومعلومات أساسية
SMALL السعر المتغير الصغير الذي يتضمّن صورة صغيرة ومعلومات أساسية
X_LARGE إصدار كبير جدًا يتضمّن لوحة صور مجمّعة ومراجعات ومعلومات شاملة عن المكان

فئة PlaceListElement

google.maps.places.PlaceListElement class

عنصر HTML يعرض نتائج بحث عن مكان في قائمة استخدِم الطريقتَين configureFromSearchByTextRequest() أو configureFromSearchNearbyRequest() لتحديد الطلب الذي تريد عرض النتائج له. لاستخدام عنصر قائمة الأماكن، فعِّل Places UI Kit API لمشروعك في Google Cloud Console.

العنصر المخصّص:
<gmp-place-list selectable></gmp-place-list>

يمتدّ هذا الصف إلى HTMLElement.

تنفّذ هذه الفئة PlaceListElementOptions.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceListElement} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
PlaceListElement
PlaceListElement([options])
المَعلمات: 
places
النوع:  Array<Place>
للقراءة فقط. صفيف من Place عنصر يحتوي على أرقام التعريف والمواقع الجغرافية ومجالات العرض للأماكن المعروضة حاليًا
selectable
النوع:  boolean
ما إذا كانت عناصر القائمة قابلة للاختيار أم لا إذا كانت القيمة true، ستكون عناصر القائمة أزرارًا تُرسِل الحدث gmp-placeselect عند النقر عليها. تتوفّر أيضًا إمكانية التنقّل والاختيار باستخدام لوحة المفاتيح.
سمة HTML:
  • <gmp-place-list selectable></gmp-place-list>
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه.
  • listener:  EventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent.
  • options:  boolean|AddEventListenerOptions optional اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
configureFromSearchByTextRequest
configureFromSearchByTextRequest(request)
المَعلمات: 
  • request:  SearchByTextRequest الطلب الذي يتم عرض النتائج له. سمة fields في SearchByTextRequest غير مطلوبة.
القيمة المعروضة:  Promise<void> وعد يتم حلّه بعد تحميل بيانات المكان وعرضها.
لضبط التطبيق المصغّر لعرض نتائج البحث من طلب Places Text Search API
configureFromSearchNearbyRequest
configureFromSearchNearbyRequest(request)
المَعلمات: 
  • request:  SearchNearbyRequest الطلب الذي يتم عرض النتائج له. سمة fields في SearchNearbyRequest غير مطلوبة.
القيمة المعروضة:  Promise<void> وعد يتم حلّه بعد تحميل بيانات المكان وعرضها.
لضبط التطبيق المصغّر لعرض نتائج البحث من طلب Places Nearby Search API
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
القيمة المعروضة:  void
تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener.
gmp-load
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تحميل العنصر وعرض محتواه. لا يتم تجميع هذا الحدث.
gmp-placeselect
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عندما يختار أحد المستخدِمين مكانًا. يحتوي على عنصر Place وفهرس المكان المحدّد في القائمة.
gmp-requesterror
function(event)
الوسيطات: 
يتمّ تنشيط هذا الحدث عند رفض طلب موجّه إلى الخلفية (مثل مفتاح واجهة برمجة التطبيقات غير صحيح). لا يتم تصعيد هذا الحدث.

واجهة PlaceListElementOptions

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

خيارات PlaceListElement
selectable optional
النوع:  boolean optional
عرض PlaceListElement.selectable

فئة PlaceListPlaceSelectEvent

google.maps.places.PlaceListPlaceSelectEvent class

يُرسِل PlaceListElement هذا الحدث عندما يختار المستخدِم مكانًا.

يمتدّ هذا الصف إلى Event.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlaceListPlaceSelectEvent} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
index
النوع:  number
فهرس القائمة للمكان المحدّد
place
النوع:  Place
عنصر Place يحتوي على رقم التعريف والموقع الجغرافي ومساحة العرض للمكان المحدّد

الإكمال التلقائي class

google.maps.places.Autocomplete class

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

google.maps.places.SearchBox class

تطبيق مصغّر يقدّم اقتراحات لطلبات البحث استنادًا إلى النص الذي يُدخله المستخدم يتم إرفاقه بعنصر إدخال من النوع 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
المنطقة التي يجب توجيه توقّعات طلبات البحث نحوها وتتّجه التوقّعات نحو طلبات البحث التي تستهدِف هذه الحدود، ولكن ليس فقط.