Places Widgets

فئة PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement صف

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

العنصر المخصّص:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng|lat,lng,altitude" requested-language="string" requested-region="string" unit-system="metric|imperial" types="type1 type2 type3..."></gmp-place-autocomplete>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceAutocompleteElement} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
المَعلمات: 
AlphaincludedPrimaryTypes
النوع:  Array<string> optional
تضمين نوع المكان الأساسي (على سبيل المثال، "restaurant" أو "gas_station")

لا يتم عرض "مكان" إلا إذا كان نوعه الأساسي مضمّنًا في هذه القائمة. يمكن تحديد ما يصل إلى 5 قيم. في حال عدم تحديد أي أنواع، سيتم عرض جميع أنواع "الأماكن".
سمة HTML:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
AlphaincludedRegionCodes
النوع:  Array<string> optional
تضمين النتائج في المناطق المحدّدة فقط، والتي يتم تحديدها على أنّها ما يصل إلى 15 رمزًا من رموز CLDR المكوّنة من حرفَين لن تؤدي المجموعة الفارغة إلى حصر النتائج. إذا تم ضبط كل من locationRestriction وincludedRegionCodes، ستظهر النتائج في منطقة التقاطع.
سمة HTML:
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
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-place-autocomplete name="string"></gmp-place-autocomplete>
Alphaorigin
نقطة البداية التي سيتم حساب المسافة منها. إذا لم يتم تحديدها، لن يتم احتساب المسافة. لا يتم استخدام الارتفاع في عملية الاحتساب، إذا تم توفيره.
سمة HTML:
  • <gmp-place-autocomplete origin="lat,lng|lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage
النوع:  string optional
معرّف اللغة التي يجب عرض النتائج بها، إذا كان ذلك ممكنًا قد يتم منح النتائج باللغة المحدّدة ترتيبًا أعلى، ولكن لا تقتصر الاقتراحات على هذه اللغة. اطّلِع على قائمة اللغات المتاحة.
سمة HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
النوع:  string optional
رمز المنطقة المستخدَم لتنسيق النتائج وفلترتها ولا يقتصر على تقديم اقتراحات في هذا البلد. يقبل رمز المنطقة قيمة ccTLD ("نطاق المستوى الأعلى") مكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز ccTLD الخاص بالمملكة المتحدة هو "uk" (.co.uk)، بينما رمز ISO 3166-1 هو "gb" (وهو يشير من الناحية الفنية إلى "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
سمة HTML:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
AlphaunitSystem
النوع:  UnitSystem optional
نظام الوحدات المستخدَم لعرض المسافات في حال عدم تحديدها، يتم تحديد نظام الوحدات من خلال requestedRegion.
سمة HTML:
  • <gmp-place-autocomplete unit-system="metric|imperial"></gmp-place-autocomplete>
BetacomponentRestrictions
النوع:  ComponentRestrictions optional
قيود المكوّن تُستخدَم قيود المكوّنات لحصر التوقّعات على تلك التي تقع ضمن المكوّن الرئيسي فقط. على سبيل المثال، البلد.
Betatypes
النوع:  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-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])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • ‫listener:  EventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • options:  boolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener.
gmp-error
function(errorEvent)
الوسيطات: 
يتم إطلاق هذا الحدث عندما يتم رفض طلب إلى الخلفية (مثل مفتاح واجهة برمجة تطبيقات غير صحيح). لا يظهر هذا الحدث.
gmp-select
function(placePredictionSelectEvent)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يختار المستخدم توقّعًا لمكان. يحتوي على عنصر PlacePrediction يمكن تحويله إلى عنصر Place.
gmp-placeselect
function(placeAutocompletePlaceSelectEvent)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يختار المستخدم توقّعًا لمكان. يحتوي على عنصر "مكان".

PlaceAutocompleteElementOptions interface

google.maps.places.PlaceAutocompleteElementOptions interface

خيارات إنشاء PlaceAutocompleteElement للحصول على وصف لكل موقع، يُرجى الرجوع إلى الموقع الذي يحمل الاسم نفسه في فئة PlaceAutocompleteElement.
BetacomponentRestrictions optional
النوع:  ComponentRestrictions optional
AlphaincludedPrimaryTypes optional
النوع:  Array<string> optional
AlphaincludedRegionCodes optional
النوع:  Array<string> optional
locationBias optional
النوع:  LocationBias optional
locationRestriction optional
النوع:  LocationRestriction optional
name optional
النوع:  string optional
Alphaorigin optional
requestedLanguage optional
النوع:  string optional
Betatypes optional
النوع:  Array<string> optional
AlphaunitSystem optional
النوع:  UnitSystem optional

فئة PlaceAutocompletePlaceSelectEvent

google.maps.places.PlaceAutocompletePlaceSelectEvent صف

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

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

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

فئة PlacePredictionSelectEvent

google.maps.places.PlacePredictionSelectEvent صف

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
placePrediction
النوع:  PlacePrediction

فئة PlaceAutocompleteRequestErrorEvent

google.maps.places.PlaceAutocompleteRequestErrorEvent صف

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

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

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

PlaceDetailsElementPlaceDetailsElement

google.maps.places.PlaceDetailsElement صف

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

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

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceDetailsElement} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
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])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • ‫listener:  EventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • options:  boolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener.
gmp-load
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يتم تحميل العنصر وعرض محتواه. لا يظهر هذا الحدث.
gmp-requesterror
function(event)
الوسيطات: 
يتم إطلاق هذا الحدث عندما يتم رفض طلب إلى الخلفية (مثل مفتاح واجهة برمجة تطبيقات غير صحيح). لا يظهر هذا الحدث.

PlaceDetailsElementOptions interface

google.maps.places.PlaceDetailsElementOptions interface

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

ثوابت PlaceDetailsSize

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

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

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

PlaceListElement class

google.maps.places.PlaceListElement صف

عنصر 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").
اطّلِع على المكتبات في Maps JavaScript API.
PlaceListElement
PlaceListElement([options])
المَعلمات: 
places
النوع:  Array<Place>
للقراءة فقط مصفوفة من عناصر Place تحتوي على أرقام التعريف والمواقع الجغرافية وإطارات العرض للأماكن المعروضة حاليًا.
selectable
النوع:  boolean
تحديد ما إذا كانت عناصر القائمة قابلة للاختيار إذا كانت القيمة "صحيح"، ستكون عناصر القائمة عبارة عن أزرار تُرسِل الحدث 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])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي ستتم إزالة معالج الأحداث الخاص به.
  • ‫listener:  EventListener|EventListenerObject أداة معالجة الأحداث التي سيتم إزالتها من هدف الحدث.
  • options:  boolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العائد:  void
تزيل هذه الطريقة أداة معالجة الأحداث التي تم تسجيلها سابقًا باستخدام addEventListener من العنصر المستهدف. راجِع removeEventListener.
gmp-load
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يتم تحميل العنصر وعرض محتواه. لا يظهر هذا الحدث.
gmp-placeselect
function(event)
الوسيطات: 
يتمّ تنشيط هذا الحدث عندما يختار المستخدم مكانًا. يحتوي على عنصر Place وفهرس المكان المحدّد في القائمة.
gmp-requesterror
function(event)
الوسيطات: 
يتم إطلاق هذا الحدث عندما يتم رفض طلب إلى الخلفية (مثل مفتاح واجهة برمجة تطبيقات غير صحيح). لا يظهر هذا الحدث.

PlaceListElementOptions interface

google.maps.places.PlaceListElementOptions interface

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

PlaceListPlaceSelectEvent class

google.maps.places.PlaceListPlaceSelectEvent صف

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

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

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

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

google.maps.places.Autocomplete صف

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Autocomplete} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
Autocomplete
Autocomplete(inputField[, opts])
المَعلمات: 
تنشئ هذه الدالة مثيلاً جديدًا من Autocomplete يتم إرفاقه بحقل الإدخال النصي المحدّد مع الخيارات المحدّدة.
getBounds
getBounds()
المَعلمات:  بدون
قيمة الإرجاع:  LatLngBounds|undefined حدود التحيز.
تعرِض هذه السمة الحدود التي يتم فيها تحيز التوقعات.
getFields
getFields()
المَعلمات:  بدون
قيمة العائد:  Array<string>|undefined
تعرض هذه السمة الحقول التي سيتم تضمينها في استجابة التفاصيل عند استرداد التفاصيل بنجاح. للاطّلاع على قائمة بالحقول، يُرجى الانتقال إلى PlaceResult.
getPlace
getPlace()
المَعلمات:  بدون
قيمة الإرجاع:  PlaceResult المكان الذي اختاره المستخدم.
تعرض هذه السمة تفاصيل المكان الذي اختاره المستخدم إذا تم استرداد التفاصيل بنجاح. بخلاف ذلك، يتم عرض عنصر Place زائف، مع ضبط السمة 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 interface

الخيارات التي يمكن ضبطها على عنصر 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 صف

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {SearchBox} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
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 interface

الخيارات التي يمكن ضبطها على عنصر SearchBox
bounds optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
المنطقة التي يجب أن تميل إليها توقّعات طلب البحث. تكون التوقعات متحيزة نحو الطلبات التي تستهدف هذه الحدود، ولكنها لا تقتصر عليها.