Places Widgets

فئة PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement صف

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

تستخدم السمة PlaceAutocompleteElement تلقائيًا AutocompleteSessionToken داخليًا لتجميع مراحل طلب البحث والاختيار في عملية البحث بالإكمال التلقائي التي يجريها المستخدم.

ستتضمّن تلقائيًا المكالمة الأولى إلى Place.fetchFields على Place التي تعرضها PlacePrediction.toPlace الرمز المميّز للجلسة المستخدَم لجلب PlacePrediction.

يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/place-session-tokens لمزيد من التفاصيل حول طريقة عمل الجلسات.

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

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

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

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

لا يتم عرض "مكان" إلا إذا كان نوعه الأساسي مضمّنًا في هذه القائمة. يمكن تحديد ما يصل إلى 5 قيم. في حال عدم تحديد أي أنواع، سيتم عرض جميع أنواع "الأماكن".
سمة HTML:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes
النوع:  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>
origin
نقطة البداية التي سيتم حساب المسافة منها. إذا لم يتم تحديدها، لن يتم احتساب المسافة. لا يتم استخدام الارتفاع في عملية الاحتساب، إذا تم توفيره.
سمة HTML:
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="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>
unitSystem
النوع:  UnitSystem optional
نظام الوحدات المستخدَم لعرض المسافات في حال عدم تحديدها، يتم تحديد نظام الوحدات من خلال requestedRegion.
سمة HTML:
  • <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete>
  • <gmp-place-autocomplete unit-system="imperial"></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.

PlaceAutocompleteElementOptions interface

google.maps.places.PlaceAutocompleteElementOptions interface

خيارات إنشاء PlaceAutocompleteElement للحصول على وصف لكل موقع، يُرجى الرجوع إلى الموقع الذي يحمل الاسم نفسه في فئة PlaceAutocompleteElement.
locationBias optional
النوع:  LocationBias optional
locationRestriction optional
النوع:  LocationRestriction optional
name optional
النوع:  string optional
requestedLanguage optional
النوع:  string optional

فئة PlacePredictionSelectEvent

google.maps.places.PlacePredictionSelectEvent صف

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

حوِّل placePrediction إلى Place من خلال استدعاء PlacePrediction.toPlace.

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

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

فئة PlaceAutocompleteRequestErrorEvent

google.maps.places.PlaceAutocompleteRequestErrorEvent صف

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

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

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

فئة PlaceContextualElement

google.maps.places.PlaceContextualElement صف

أداة تستخدم رمز السياق لعرض طريقة عرض سياقية لردّ Grounding with Google Maps.

العنصر المخصّص:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceContextualElement} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
contextToken
النوع:  string optional
الرمز المميّز للسياق
سمة HTML:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
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.

واجهة PlaceContextualElementOptions

google.maps.places.PlaceContextualElementOptions interface

خيارات PlaceContextualElement
contextToken optional
النوع:  string optional
الرمز المميز للسياق الذي يوفّره الردّ من Grounding with Google Maps.

PlaceContextualListConfigElement class

google.maps.places.PlaceContextualListConfigElement صف

عنصر HTML يضبط خيارات لعرض القائمة في "العنصر السياقي الخاص بالمكان".

العنصر المخصّص:
<gmp-place-contextual-list-config layout="compact" map-hidden></gmp-place-contextual-list-config>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
layout
النوع:  PlaceContextualListLayout optional
التنسيق
سمة HTML:
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كانت الخريطة مخفية.
سمة HTML:
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
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.

PlaceContextualListConfigElementOptions interface

google.maps.places.PlaceContextualListConfigElementOptions interface

خيارات PlaceContextualListConfigElement
layout optional
النوع:  PlaceContextualListLayout optional
التنسيق القيمة التلقائية هي PlaceContextualListLayout.VERTICAL.
mapHidden optional
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كانت الخريطة مخفية. الإعداد التلقائي هو عرض الخريطة (القيمة false).

PlaceContextualListLayout constants

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

قائمة التنسيقات التي يتيحها "العنصر السياقي الخاص بالمكان" لعرض القائمة

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceContextualListLayout} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
COMPACT تنسيق القائمة المختصرة: يتم عرض عناصر القائمة كروابط على سطر واحد، مع عرض العناصر الزائدة في قائمة منسدلة.
VERTICAL تخطيط القائمة العمودية: يتم عرض عناصر القائمة على شكل بطاقات في قائمة عمودية.

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 نسخة كبيرة جدًا تتضمّن مجموعة صور ومراجعات ومعلومات شاملة عن المكان

PlaceDetailsCompactElementPlaceDetailsCompactElement

google.maps.places.PlaceDetailsCompactElement صف

تعرض هذه البطاقة تفاصيل حول مكان ما بتنسيق مضغوط. أضِف PlaceDetailsPlaceRequestElement لتحديد المكان المطلوب عرضه. أضِف PlaceContentConfigElement أو PlaceStandardContentElement أو PlaceAllContentElement لتحديد المحتوى الذي تريد عرضه.

لاستخدام هذا العنصر، فعِّل Places UI Kit API لمشروعك في Google Cloud Console.

العنصر المخصّص:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
المَعلمات: 
orientation
النوع:  PlaceDetailsOrientation optional
القيمة التلقائية: PlaceDetailsOrientation.VERTICAL
تمثّل هذه السمة صيغة اتجاه العنصر (رأسي أو أفقي).
سمة HTML:
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
النوع:  Place optional
للقراءة فقط عنصر المكان الذي يحتوي على المعرّف والموقع الجغرافي ونافذة العرض للمكان المعروض حاليًا
truncationPreferred
النوع:  boolean
القيمة التلقائية: false
في حال ضبط القيمة على "true"، يتم اقتطاع اسم المكان وعنوانه ليناسبا سطرًا واحدًا بدلاً من التفافهما.
سمة HTML:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-mat-color-info
لون عناصر واجهة المستخدم التي تتضمّن معلومات. يُستخدَم لرمز الكرسي المتحرّك.
--gmp-mat-color-negative
لون عناصر واجهة المستخدم التي تعبّر عن مشاعر سلبية تُستخدَم لعرض النص "مغلق" في حالة "مفتوح الآن".
--gmp-mat-color-neutral-container
لون الحاوية لعناصر واجهة المستخدم المحايدة المملوءة يُستخدم للعناصر النائبة للصور.
--gmp-mat-color-on-secondary-container
لون النص والرموز مقارنةً بلون الحاوية الثانوية يُستخدم للنص والرموز على الزر "فتح في خرائط Google".
--gmp-mat-color-on-surface
لون النص والرموز على أي لون سطح يُستخدم للنص العادي.
--gmp-mat-color-on-surface-variant
لون أقل أهمية للنصوص والرموز مقارنةً بأي لون سطح تُستخدَم للنصوص الأقل أهمية.
--gmp-mat-color-outline-decorative
لون المخطط التفصيلي للعناصر غير التفاعلية تُستخدَم لحدود العنصر.
--gmp-mat-color-positive
لون عناصر واجهة المستخدم التي تعكس مشاعر إيجابية تُستخدَم لعرض النص "مفتوح" في حالة "مفتوح الآن".
--gmp-mat-color-primary
لون النص التفاعلي والرموز مقارنةً بلون السطح تُستخدَم لعرض عدد المراجعات والروابط في مربّع حوار تحديد المصدر.
--gmp-mat-color-secondary-container
لون تعبئة أقل بروزًا مقارنةً بالسطح، وذلك للمكوّنات المتنحية مثل الأزرار اللونية. يُستخدَم لخلفية الزر "فتح في خرائط Google".
--gmp-mat-color-surface
لون الخلفيات تُستخدَم لخلفيات العنصر ومربّع حوار تحديد المصدر.
--gmp-mat-font-body-medium
تُستخدَم لنص الرسالة في مربّع حوار تحديد المصدر.
--gmp-mat-font-body-small
تُستخدَم لعرض عنوان المكان وتقييمه ونوعه وسعره وحالة "مفتوح الآن".
--gmp-mat-font-family
مجموعة الخطوط الأساسية المستخدَمة لجميع النصوص
--gmp-mat-font-headline-medium
تُستخدَم لنص العنوان في مربّع حوار تحديد المصدر.
--gmp-mat-font-label-large
يُستخدَم لزر "فتح في خرائط Google" والروابط في مربّع حوار تحديد المصدر.
--gmp-mat-font-title-small
تُستخدَم لاسم المكان.
background-color
تتجاوز هذه السمة لون الخلفية للعنصر.
border
تستبدل هذه السمة حدود العنصر.
border-radius
تتجاوز هذه السمة نصف قطر حدود العنصر.
color-scheme
تشير إلى نظام الألوان الذي يمكن عرض هذا العنصر به. لمزيد من التفاصيل، يمكنك الاطّلاع على color-scheme المستندات. القيمة التلقائية هي color-scheme: light dark.
font-size
يتم تغيير حجم كل النصوص والرموز في العنصر، والتي يتم تحديدها داخليًا بوحدات em. القيمة التلقائية هي 16px.
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(event)
الوسيطات: 
يتم إطلاق هذا الحدث عندما يتم رفض طلب إلى الخلفية (مثل مفتاح واجهة برمجة تطبيقات غير صحيح). لا يظهر هذا الحدث.
gmp-load
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يتم تحميل العنصر وعرض محتواه. لا يظهر هذا الحدث.

واجهة PlaceDetailsCompactElementOptions

google.maps.places.PlaceDetailsCompactElementOptions interface

خيارات PlaceDetailsCompactElement
orientation optional
النوع:  PlaceDetailsOrientation optional
يمكنك الاطّلاع على PlaceDetailsCompactElement.orientation.
truncationPreferred optional
النوع:  boolean optional
يمكنك الاطّلاع على PlaceDetailsCompactElement.truncationPreferred.

ثوابت PlaceDetailsOrientation

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

خيارات الاتجاه لـ "PlaceDetailsCompactElement"

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

PlaceDetailsPlaceRequestElement class

google.maps.places.PlaceDetailsPlaceRequestElement صف

تضبط هذه السمة عنصر "تفاصيل المكان" المضغوط لتحميل البيانات استنادًا إلى عنصر مكان أو معرّف أو اسم مورد. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceDetailsCompactElement لتحميل البيانات الخاصة بالمكان المحدّد.

العنصر المخصّص:
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
المَعلمات: 
place
النوع:  Place optional
تمثّل هذه السمة عنصر المكان أو رقم تعريفه أو اسم المورد الذي سيتم عرض تفاصيله في عنصر "تفاصيل المكان" المضغوط. تعكس هذه السمة السمة كاسم مورد.
سمة HTML:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
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.

PlaceDetailsPlaceRequestElementOptions interface

google.maps.places.PlaceDetailsPlaceRequestElementOptions interface

خيارات PlaceDetailsPlaceRequestElement
place optional
النوع:  Place|string optional
عرض PlaceDetailsPlaceRequestElement.place

فئة PlaceContentConfigElement

google.maps.places.PlaceContentConfigElement صف

تضبط هذه السمة المحتوى الذي سيتم عرضه بواسطة عنصر "تفاصيل المكان" المضغوط. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceDetailsCompactElement لاستخدامه. أضِف أيًا من العناصر التالية إلى PlaceContentConfigElement لعرض المحتوى ذي الصلة:
PlaceMediaElement وPlaceAddressElement وPlaceRatingElement وPlaceTypeElement وPlacePriceElement وPlaceAccessibleEntranceIconElement وPlaceOpenNowStatusElement وPlaceAttributionElement
لا يهم ترتيب العناصر الفرعية، إذ يعرض العنصر المحتوى بترتيب عادي لا يمكن تخصيصه.

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

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

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

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

PlaceContentConfigElementOptions interface

google.maps.places.PlaceContentConfigElementOptions interface

خيارات PlaceContentConfigElement

PlaceMediaElement class

google.maps.places.PlaceMediaElement صف

تضبط هذه السمة عنصرًا مضغوطًا من "تفاصيل المكان" لعرض وسائط مكان، مثل الصور. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceContentConfigElement لاستخدامه.

العنصر المخصّص:
<gmp-place-media lightbox-preferred></gmp-place-media>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceMediaElement} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
PlaceMediaElement
PlaceMediaElement([options])
المَعلمات: 
lightboxPreferred
النوع:  boolean optional
القيمة التلقائية: false
تحديد ما إذا كان سيتم تفعيل أو إيقاف عرض الوسائط في مربّع الحوار، في الحالات التي يتوفّر فيها الخياران
سمة HTML:
  • <gmp-place-media lightbox-preferred></gmp-place-media>
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.

واجهة PlaceMediaElementOptions

google.maps.places.PlaceMediaElementOptions interface

خيارات PlaceMediaElement
lightboxPreferred optional
النوع:  boolean optional
يمكنك الاطّلاع على PlaceMediaElement.lightboxPreferred.

فئة PlaceAddressElement

google.maps.places.PlaceAddressElement صف

تضبط هذه السمة عنصرًا مضغوطًا من "تفاصيل المكان" لعرض عنوان مكان. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceContentConfigElement لاستخدامه.

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

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

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

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

PlaceAddressElementOptions interface

google.maps.places.PlaceAddressElementOptions interface

خيارات PlaceAddressElement

فئة PlaceRatingElement

google.maps.places.PlaceRatingElement صف

تضبط هذه السمة عنصر "تفاصيل المكان" المضغوط لعرض تقييم المكان. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceContentConfigElement لاستخدامه.

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

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

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

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

PlaceRatingElementOptions interface

google.maps.places.PlaceRatingElementOptions interface

خيارات PlaceRatingElement

فئة PlaceTypeElement

google.maps.places.PlaceTypeElement صف

تضبط هذه السمة عنصر "تفاصيل المكان المختصرة" لعرض نوع المكان. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceContentConfigElement لاستخدامه.

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

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

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

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

واجهة PlaceTypeElementOptions

google.maps.places.PlaceTypeElementOptions interface

خيارات PlaceTypeElement

فئة PlacePriceElement

google.maps.places.PlacePriceElement صف

تضبط هذه السمة عنصرًا مضغوطًا خاصًا بتفاصيل المكان لعرض مستوى سعر المكان أو نطاق سعره. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceContentConfigElement لاستخدامه.

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

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

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

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

PlacePriceElementOptions interface

google.maps.places.PlacePriceElementOptions interface

خيارات PlacePriceElement

PlaceAccessibleEntranceIconElement PlaceAccessibleEntranceIconElement

google.maps.places.PlaceAccessibleEntranceIconElement صف

تضبط هذه السمة عنصر "تفاصيل المكان" المدمج لعرض رمز كرسي متحرك إذا كان المكان يوفّر مدخلاً مناسبًا للكراسي المتحركة. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceContentConfigElement لاستخدامه.

العنصر المخصّص:
<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>

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

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

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

PlaceAccessibleEntranceIconElementOptions interface

google.maps.places.PlaceAccessibleEntranceIconElementOptions interface

خيارات PlaceAccessibleEntranceIconElement

PlaceOpenNowStatusElement class

google.maps.places.PlaceOpenNowStatusElement صف

تضبط هذه السمة عنصر "تفاصيل المكان" المضغوط لعرض حالة المكان الحالية، سواء كان مفتوحًا أو مغلقًا. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceContentConfigElement لاستخدامه.

العنصر المخصّص:
<gmp-place-open-now-status></gmp-place-open-now-status>

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

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

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

PlaceOpenNowStatusElementOptions interface

google.maps.places.PlaceOpenNowStatusElementOptions interface

خيارات PlaceOpenNowStatusElement

فئة PlaceAttributionElement

google.maps.places.PlaceAttributionElement صف

تسمح بتخصيص نص تحديد المصدر في "خرائط Google" في عنصر "تفاصيل المكان" المضغوط. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceContentConfigElement لاستخدامه. في حال حذف هذا العنصر، سيظلّ مصدر المحتوى معروضًا بالألوان التلقائية.

العنصر المخصّص:
<gmp-place-attribution dark-scheme-color="white" light-scheme-color="white"></gmp-place-attribution>

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlaceAttributionElement} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
PlaceAttributionElement
PlaceAttributionElement([options])
المَعلمات: 
darkSchemeColor
النوع:  AttributionColor optional
القيمة التلقائية: AttributionColor.WHITE
لون بيان تحديد المصدر في "خرائط Google" في الوضع الداكن
سمة HTML:
  • <gmp-place-attribution dark-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="gray"></gmp-place-attribution>
lightSchemeColor
النوع:  AttributionColor optional
القيمة التلقائية: AttributionColor.GRAY
لون تحديد المصدر في "خرائط Google" في الوضع الفاتح
سمة HTML:
  • <gmp-place-attribution light-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="gray"></gmp-place-attribution>
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.

PlaceAttributionElementOptions interface

google.maps.places.PlaceAttributionElementOptions interface

خيارات PlaceAttributionElement
darkSchemeColor optional
النوع:  AttributionColor optional
يمكنك الاطّلاع على PlaceAttributionElement.darkSchemeColor.
lightSchemeColor optional
النوع:  AttributionColor optional
يمكنك الاطّلاع على PlaceAttributionElement.lightSchemeColor.

ثوابت AttributionColor

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

خيارات الألوان لنص الإحالة في "خرائط Google" يمكن تخصيص معلومات تحديد المصدر لاستخدام أي من هذه الألوان.

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

فئة PlaceAllContentElement

google.maps.places.PlaceAllContentElement صف

تضبط هذه السمة عنصرًا مضغوطًا من "تفاصيل المكان" لعرض كل المحتوى المتاح. أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceDetailsCompactElement لاستخدامه.

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

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

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

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

واجهة PlaceAllContentElementOptions

google.maps.places.PlaceAllContentElementOptions interface

خيارات PlaceAllContentElement

فئة PlaceStandardContentElement

google.maps.places.PlaceStandardContentElement صف

تضبط هذه السمة عنصرًا مضغوطًا خاصًا بتفاصيل المكان لعرض مجموعة عادية من المحتوى (الوسائط والتقييم والنوع والسعر ورمز المدخل المناسب لذوي الاحتياجات الخاصة وحالة "مفتوح الآن"). أضِف هذا العنصر كعنصر ثانوي لعنصر PlaceDetailsCompactElement لاستخدامه.

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

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

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

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

PlaceStandardContentElementOptions interface

google.maps.places.PlaceStandardContentElementOptions interface

خيارات PlaceStandardContentElement

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