Places Widgets

PlaceAutocompleteElement class

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

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

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

سيتضمّن الطلب الأول إلى 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>
placeholder
النوع:  string
النص المؤقت الذي سيتم عرضه في عنصر الإدخال.
requestedLanguage
النوع:  string optional
معرّف اللغة التي يجب عرض النتائج بها، إن أمكن. قد يتم منح النتائج باللغة المحدّدة ترتيبًا أعلى، ولكن لا تقتصر الاقتراحات على هذه اللغة. اطّلِع على قائمة اللغات المتاحة.
سمة HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
النوع:  string optional
رمز منطقة يُستخدَم لتنسيق النتائج وفلترتها ولا يفرض قيودًا على الاقتراحات لهذا البلد. يقبل رمز المنطقة قيمة ccTLD ("نطاق المستوى الأعلى") المكوّنة من حرفَين. تتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق المستوى الأعلى الذي يمثّل رمز البلد للمملكة المتحدة هو "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>
value
النوع:  string
قيمة عنصر الإدخال
prediction-item-icon
تقبل هذه الخانة عنصر <template> واحدًا بالضبط لعرضه كرمز يظهر بجانب عنصر التوقّع.
input
عنصر الإدخال لعنصر الإكمال التلقائي
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.
background-color
تلغي هذه السمة لون خلفية العنصر.
border
تتجاوز هذه السمة حدود العنصر.
border-radius
تتجاوز هذه السمة نصف قطر حدود العنصر.
color
تتجاوز هذه السمة خط العنصر.
color-scheme
يشير إلى نظام الألوان الذي يمكن عرض هذا العنصر به. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات color-scheme. القيمة التلقائية هي color-scheme: light dark.
font
تتجاوز هذه السمة خط العنصر.
font-family
تتجاوز هذه السمة خط العنصر.
font-size
تتجاوز هذه السمة خط العنصر.
font-style
تتجاوز هذه السمة خط العنصر.
font-weight
تتجاوز هذه السمة خط العنصر.
line-height
تتجاوز هذه السمة خط العنصر.
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
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

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

خيارات إنشاء PlaceAutocompleteElement للاطّلاع على وصف كل سمة، يُرجى الرجوع إلى السمة التي تحمل الاسم نفسه في فئة PlaceAutocompleteElement.
includedPrimaryTypes optional
النوع:  Array<string> optional
includedRegionCodes optional
النوع:  Array<string> optional
locationBias optional
النوع:  LocationBias optional
locationRestriction optional
النوع:  LocationRestriction optional
name optional
النوع:  string optional
origin optional
requestedLanguage optional
النوع:  string optional
requestedRegion optional
النوع:  string optional
unitSystem optional
النوع:  UnitSystem optional
value 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.

BasicPlaceAutocompleteElement class

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

BasicPlaceAutocompleteElement هي فئة فرعية من HTMLElement توفّر مكوّن واجهة مستخدم لواجهة الإكمال التلقائي للأماكن API.

العنصر المخصّص:
<gmp-basic-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-basic-place-autocomplete>

هذه الفئة هي امتداد لـ HTMLElement.

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

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

لا يتم عرض مكان إلا إذا كان نوعه الأساسي مضمّنًا في هذه القائمة. يمكن تحديد ما يصل إلى 5 قيم. في حال عدم تحديد أي أنواع، يتم عرض جميع أنواع الأماكن.
سمة HTML:
  • <gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes
النوع:  Array<string> optional
تضمين النتائج في المناطق المحدّدة فقط، والتي يتم تحديدها بما يصل إلى 15 رمز منطقة مكوّن من حرفين وفقًا لمعيار CLDR. لن تؤدي المجموعة الفارغة إلى تقييد النتائج. إذا تم ضبط كل من locationRestriction وincludedRegionCodes، ستكون النتائج في منطقة التقاطع.
سمة HTML:
  • <gmp-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-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-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin
نقطة الانطلاق التي يتم احتساب المسافة منها في حال عدم تحديدها، لن يتم احتساب المسافة. ولا يتم استخدام الارتفاع في العملية الحسابية، إذا تم تقديمه.
سمة HTML:
  • <gmp-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-place-autocomplete>
requestedLanguage
النوع:  string optional
معرّف اللغة التي يجب عرض النتائج بها، إن أمكن. قد يتم منح النتائج باللغة المحدّدة ترتيبًا أعلى، ولكن لا تقتصر الاقتراحات على هذه اللغة. اطّلِع على قائمة اللغات المتاحة.
سمة HTML:
  • <gmp-basic-place-autocomplete requested-language="string"></gmp-basic-place-autocomplete>
requestedRegion
النوع:  string optional
رمز منطقة يُستخدَم لتنسيق النتائج وفلترتها ولا يفرض قيودًا على الاقتراحات لهذا البلد. يقبل رمز المنطقة قيمة ccTLD ("نطاق المستوى الأعلى") المكوّنة من حرفَين. تتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق المستوى الأعلى الذي يمثّل رمز البلد للمملكة المتحدة هو "uk"‏ (.co.uk)، في حين أنّ رمز ISO 3166-1 هو "gb" (من الناحية الفنية لكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
سمة HTML:
  • <gmp-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>
unitSystem
النوع:  UnitSystem optional
نظام الوحدات المستخدَم لعرض المسافات. في حال عدم تحديدها، يتم تحديد نظام الوحدات من خلال requestedRegion.
سمة HTML:
  • <gmp-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>
prediction-item-icon
تقبل هذه الخانة عنصر <template> واحدًا بالضبط لعرضه كرمز يظهر بجانب عنصر التوقّع.
input
عنصر الإدخال لعنصر الإكمال التلقائي
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.
background-color
تلغي هذه السمة لون خلفية العنصر.
border
تتجاوز هذه السمة حدود العنصر.
border-radius
تتجاوز هذه السمة نصف قطر حدود العنصر.
color
تتجاوز هذه السمة خط العنصر.
color-scheme
يشير إلى نظام الألوان الذي يمكن عرض هذا العنصر به. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات color-scheme. القيمة التلقائية هي color-scheme: light dark.
font
تتجاوز هذه السمة خط العنصر.
font-family
تتجاوز هذه السمة خط العنصر.
font-size
تتجاوز هذه السمة خط العنصر.
font-style
تتجاوز هذه السمة خط العنصر.
font-weight
تتجاوز هذه السمة خط العنصر.
line-height
تتجاوز هذه السمة خط العنصر.
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي تريد إزالة متتبِّع الأحداث له.
  • ‫listener:  EventListener|EventListenerObject متتبِّع الأحداث الخاص بمعالج الأحداث المطلوب إزالته من هدف الحدث
  • ‫options:  boolean|EventListenerOptions optional يمكنك الاطّلاع على الخيارات.
القيمة المعروضة:  void
تزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener.
gmp-error
function(errorEvent)
الوسيطات: 
يتم تشغيل هذا الحدث عندما يتم رفض طلب إلى الخلفية (على سبيل المثال، مفتاح واجهة برمجة التطبيقات غير صحيح). لا يتصاعد هذا الحدث.
gmp-select
function(placeSelectEvent)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يختار المستخدم توقّعًا لمكان. يحتوي على عنصر Place.

BasicPlaceAutocompleteElementOptions interface

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

خيارات إنشاء BasicPlaceAutocompleteElement.
includedPrimaryTypes optional
النوع:  Array<string> optional
includedRegionCodes optional
النوع:  Array<string> optional
locationBias optional
النوع:  LocationBias optional
locationRestriction optional
النوع:  LocationRestriction optional
name optional
النوع:  string optional
origin optional
requestedLanguage optional
النوع:  string optional
requestedRegion optional
النوع:  string optional
unitSystem optional
النوع:  UnitSystem optional

فئة PlaceDetailsElement

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

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

مثال: 

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details>

لاستخدام هذا العنصر، يجب تفعيل حزمة أدوات "خرائط Google" الجاهزة للأماكن API لمشروعك في Google Cloud Console.

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

هذه الفئة هي امتداد لـ HTMLElement.

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

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {PlaceDetailsElement} = await google.maps.importLibrary("places").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
PlaceDetailsElement
PlaceDetailsElement([options])
المَعلمات: 
place
النوع:  Place optional
للقراءة فقط. عنصر Place يحتوي على المعرّف والموقع الجغرافي وإطار العرض للمكان المعروض حاليًا
--gmp-button-border-color
لون حدود الزر "فتح في خرائط Google"
--gmp-button-border-radius
نصف قطر حدود الزر "فتح في خرائط Google"
--gmp-button-border-width
عرض حدود الزر "فتح في خرائط Google"
--gmp-collage-border-radius-outer
نصف قطر حدود الزوايا الخارجية لمجموعة الوسائط
--gmp-dialog-border-radius
تمثّل هذه السمة نصف قطر حدود مربّع حوار الإفصاح في "خرائط Google".
--gmp-mat-color-disabled-surface
لون سطح مخصّص للتعبير عن حالات غير مفعَّلة أو عدم توفّر. يُستخدَم لنجوم المراجعات الفارغة.
--gmp-mat-color-info
لون عناصر واجهة المستخدم التي تحمل طابعًا إعلاميًا يُستخدَم لرمز الكرسي المتحرّك.
--gmp-mat-color-negative
لون عناصر واجهة المستخدم التي تعبّر عن شعور سلبي يُستخدَم هذا اللون للنص "مغلق" في حالة "مفتوح الآن".
--gmp-mat-color-neutral-container
لون الحاوية لعناصر واجهة المستخدم المعبأة بلون محايد يُستخدَم للعناصر النائبة للصور وشارة تاريخ نشر المراجعة.
--gmp-mat-color-on-neutral-container
لون النص والرموز مقارنةً بلون الحاوية المحايد يُستخدَم لشارة تاريخ نشر المراجعة وشارة توفّر شاحن المركبة الكهربائية عندما لا يكون متاحًا.
--gmp-mat-color-on-positive-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-positive-container
لون الحاوية لعناصر واجهة المستخدم التي تعبّر عن مشاعر إيجابية تُستخدَم لشارة توفّر شاحن المركبات الكهربائية عندما تكون متاحة.
--gmp-mat-color-primary
لون النص والرموز التفاعلية مقارنةً بلون السطح يُستخدَم لعدد المراجعات والروابط في مربّع حوار الإفصاحات في "خرائط Google" ورابط الموقع الإلكتروني والرموز في علامة التبويب "نظرة عامة" و (تمرير مؤشر الماوس فوق / التركيز على / لون النص) في عناوين شريط علامات التبويب.
--gmp-mat-color-secondary-container
لون تعبئة أقل بروزًا مقارنةً بلون السطح، ويُستخدم للمكوّنات المتنحية مثل الأزرار النغمية. يُستخدَم لخلفية زر "الفتح في خرائط Google".
--gmp-mat-color-surface
لون الخلفيات يُستخدَم هذا اللون لخلفيات العنصر ومربّع حوار الإفصاحات في "خرائط Google".
--gmp-mat-font-body-medium
يُستخدَم لعنوان المكان وتقييمه ونوعه وسعره وحالة فتحه الآن وساعات العمل والمراجعة ورقم الهاتف والموقع الإلكتروني ورمز Plus Code وأهم الميزات والنص الأساسي في مربّع حوار الإفصاحات في "خرائط Google".
--gmp-mat-font-body-small
يُستخدَم للنص الأساسي في قائمة الميزات ضمن علامة التبويب "لمحة".
--gmp-mat-font-display-small
يُستخدَم لاسم المكان ونص كل عنوان ميزة في علامة التبويب "لمحة".
--gmp-mat-font-family
مجموعة الخطوط الأساسية المستخدَمة لكل النصوص
--gmp-mat-font-headline-medium
يُستخدَم هذا النص كعنوان في مربّع حوار الإفصاحات في "خرائط Google".
--gmp-mat-font-label-large
يُستخدَم لعناوين علامات التبويب، وزر "الفتح في خرائط Google"، ونص تحديد مصدر المراجِع في معرض الصور، ونص تحديد مصدر المراجِع في قسم المراجعات، والروابط في مربّع حوار الإفصاحات في "خرائط Google".
--gmp-mat-font-label-medium
يُستخدَم لشارة عدد الصور وشارة تاريخ نشر المراجعة.
--gmp-mat-font-title-small
يُستخدَم لعنوان كل قسم في علامة التبويب "لمحة".
--gmp-mat-spacing-extra-large
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-extra-small
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-large
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-medium
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-small
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-two-extra-large
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-star-rating-color
لون النجوم الممتلئة في التقييم
background-color
تلغي هذه السمة لون خلفية العنصر.
border
تتجاوز هذه السمة حدود العنصر.
border-radius
تتجاوز هذه السمة نصف قطر حدود العنصر.
color-scheme
يشير إلى نظام الألوان الذي يمكن عرض هذا العنصر به. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات color-scheme. القيمة التلقائية هي color-scheme: light dark.
font-size
يغيّر حجم كل النصوص والرموز في العنصر، والتي يتم تحديدها داخليًا بوحدات em. القيمة التلقائية هي 16px.
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي تريد إزالة متتبِّع الأحداث له.
  • ‫listener:  EventListener|EventListenerObject متتبِّع الأحداث الخاص بمعالج الأحداث المطلوب إزالته من هدف الحدث
  • ‫options:  boolean|EventListenerOptions optional اطّلِع على الخيارات.
القيمة المعروضة:  void
تزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener.
gmp-error
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عندما يتم رفض طلب إلى الخلفية (على سبيل المثال، مفتاح واجهة برمجة التطبيقات غير صحيح). لا يتصاعد هذا الحدث.
gmp-load
function(event)
الوسيطات: 
يتم بدء هذا الحدث عندما يحمّل العنصر محتواه ويعرضه. لا يتصاعد هذا الحدث.

PlaceDetailsElementOptions interface

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

خيارات "PlaceDetailsElement"

PlaceDetailsCompactElement class

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

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

مثال: 

 <gmp-place-details-compact>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details-compact>

لاستخدام هذا العنصر، يجب تفعيل حزمة أدوات "خرائط Google" الجاهزة للأماكن 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
للقراءة فقط. عنصر Place يحتوي على المعرّف والموقع الجغرافي وإطار العرض للمكان المعروض حاليًا
truncationPreferred
النوع:  boolean
القيمة التلقائية: false
إذا كانت القيمة صحيحة، يتم اقتطاع اسم المكان وعنوانه ليظهرا في سطر واحد بدلاً من التفافهما.
سمة HTML:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-button-border-color
لون حدود الزر "فتح في خرائط Google"
--gmp-button-border-radius
نصف قطر حدود الزر "فتح في خرائط Google"
--gmp-button-border-width
عرض حدود الزر "فتح في خرائط Google"
--gmp-dialog-border-radius
تمثّل هذه السمة نصف قطر حدود مربّع حوار الإفصاح في "خرائط Google".
--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
لون النص والرموز التفاعلية مقارنةً بلون السطح يُستخدَم لعدد المراجعات، بالإضافة إلى الروابط في مربّع حوار الإفصاحات في "خرائط Google".
--gmp-mat-color-secondary-container
لون تعبئة أقل بروزًا مقارنةً بلون السطح، ويُستخدم للمكوّنات المتنحية مثل الأزرار النغمية. يُستخدَم لخلفية زر "الفتح في خرائط Google".
--gmp-mat-color-surface
لون الخلفيات يُستخدَم هذا اللون لخلفيات العنصر ومربّع حوار الإفصاحات في "خرائط Google".
--gmp-mat-font-body-medium
يُستخدَم للنص الأساسي في مربّع حوار الإفصاحات في "خرائط Google".
--gmp-mat-font-body-small
يُستخدَم لعرض عنوان المكان وتقييمه ونوعه وسعره وحالة فتحه الآن.
--gmp-mat-font-family
مجموعة الخطوط الأساسية المستخدَمة لكل النصوص
--gmp-mat-font-headline-medium
يُستخدَم هذا النص كعنوان في مربّع حوار الإفصاحات في "خرائط Google".
--gmp-mat-font-label-large
يُستخدَم هذا الزر لفتح "خرائط Google"، وكذلك للروابط في مربّع حوار الإفصاحات في "خرائط Google" ونص تحديد مصدر المراجِع في معرض الصور.
--gmp-mat-font-label-medium
يُستخدَم لشارة عدد الصور.
--gmp-mat-font-title-small
يُستخدَم لاسم المكان.
--gmp-mat-spacing-extra-small
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-large
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-medium
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-small
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-star-rating-color
لون النجوم الممتلئة في التقييم
--gmp-thumbnail-border-radius
نصف قطر حدود الصورة المصغّرة للمكان
background-color
تلغي هذه السمة لون خلفية العنصر.
border
تتجاوز هذه السمة حدود العنصر.
border-radius
تتجاوز هذه السمة نصف قطر حدود العنصر.
color-scheme
يشير إلى نظام الألوان الذي يمكن عرض هذا العنصر به. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات color-scheme. القيمة التلقائية هي color-scheme: light dark.
font-size
يغيّر حجم كل النصوص والرموز في العنصر، والتي يتم تحديدها داخليًا بوحدات em. القيمة التلقائية هي 16px.
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
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 interface

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

خيارات "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

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

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

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
 </gmp-place-details>

العنصر المخصّص:
<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
القيمة التلقائية: null
تمثّل هذه السمة عنصر المكان أو رقم تعريفه أو اسم المورد لعرض تفاصيله في عنصر "تفاصيل المكان" المصغّر. تعكس هذه السمة السمة كاسم مورد.
سمة HTML:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي تريد إزالة متتبِّع الأحداث له.
  • ‫listener:  EventListener|EventListenerObject متتبِّع الأحداث الخاص بمعالج الأحداث المطلوب إزالته من هدف الحدث
  • ‫options:  boolean|EventListenerOptions optional يمكنك الاطّلاع على الخيارات.
القيمة المعروضة:  void
تزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener.

واجهة PlaceDetailsPlaceRequestElementOptions

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

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

PlaceDetailsLocationRequestElement

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

لضبط PlaceDetailsCompactElement أو PlaceDetailsElement لتحميل البيانات استنادًا إلى الموقع الجغرافي أضِف هذا العنصر كعنصر فرعي لـ PlaceDetailsCompactElement أو PlaceDetailsElement لتحميل البيانات للموقع الجغرافي المحدّد. على سبيل المثال: 

 <gmp-place-details>
   <gmp-place-details-location-request
     location="37.6207665,-122.4284806"
   ></gmp-place-details-location-request>
 </gmp-place-details>

العنصر المخصّص:
<gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

هذه الفئة هي امتداد لـ HTMLElement.

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

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
PlaceDetailsLocationRequestElement
PlaceDetailsLocationRequestElement([options])
المَعلمات: 
location
القيمة التلقائية: null
يشير هذا المصطلح إلى الموقع الجغرافي الذي سيتم عرض تفاصيله في عنصر "تفاصيل المكان". يتم تطبيعها إلى LatLngAltitude.
سمة HTML:
  • <gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي تريد إزالة متتبِّع الأحداث له.
  • ‫listener:  EventListener|EventListenerObject متتبِّع الأحداث الخاص بمعالج الأحداث المطلوب إزالته من هدف الحدث
  • ‫options:  boolean|EventListenerOptions optional يمكنك الاطّلاع على الخيارات.
القيمة المعروضة:  void
تزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener.

PlaceDetailsLocationRequestElementOptions interface

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

خيارات "PlaceDetailsLocationRequestElement"
location optional
الموقع الجغرافي الذي سيتم عرض المكان له

فئة PlaceSearchElement

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

تعرض هذه الميزة نتائج البحث عن الأماكن في قائمة. أضِف PlaceTextSearchRequestElement أو PlaceNearbySearchRequestElement لتحديد الطلب الذي تريد عرض النتائج له. أضِف PlaceContentConfigElement أو PlaceStandardContentElement أو PlaceAllContentElement لتحديد المحتوى الذي تريد عرضه.

مثال: 

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

لاستخدام عنصر "البحث عن الأماكن"، فعِّل Places UI Kit API لمشروعك في Google Cloud Console.

العنصر المخصّص:
<gmp-place-search attribution-position="top" orientation="vertical" selectable truncation-preferred></gmp-place-search>

هذه الفئة هي امتداد لـ HTMLElement.

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

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {PlaceSearchElement} = await google.maps.importLibrary("places").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
PlaceSearchElement
PlaceSearchElement([options])
المَعلمات: 
attributionPosition
النوع:  PlaceSearchAttributionPosition optional
القيمة التلقائية: PlaceSearchAttributionPosition.TOP
موضع شعار تحديد المصدر وزر الإفصاح القانوني
سمة HTML:
  • <gmp-place-search attribution-position="top"></gmp-place-search>
  • <gmp-place-search attribution-position="bottom"></gmp-place-search>
orientation
النوع:  PlaceSearchOrientation optional
القيمة التلقائية: PlaceSearchOrientation.VERTICAL
تمثّل هذه السمة صيغة اتجاه العنصر (عمودي أو أفقي).
سمة HTML:
  • <gmp-place-search orientation="vertical"></gmp-place-search>
  • <gmp-place-search orientation="horizontal"></gmp-place-search>
places
النوع:  Array<Place>
للقراءة فقط. مصفوفة من عناصر Place تحتوي على أرقام التعريف والمواقع الجغرافية ومساحات العرض للأماكن المعروضة حاليًا
selectable
النوع:  boolean optional
القيمة التلقائية: false
ما إذا كانت عناصر القائمة قابلة للاختيار أم لا إذا كانت القيمة "صحيح"، ستكون عناصر القائمة عبارة عن أزرار تُرسل الحدث gmp-select عند النقر عليها. ويمكن أيضًا التنقّل والاختيار باستخدام لوحة المفاتيح المخصّصة لتسهيل الاستخدام.
سمة HTML:
  • <gmp-place-search selectable></gmp-place-search>
truncationPreferred
النوع:  boolean optional
القيمة التلقائية: false
إذا كانت القيمة "صحيح"، يتم اقتطاع أسطر معيّنة من المحتوى لتلائم سطرًا واحدًا بدلاً من التفاف النص.
سمة HTML:
  • <gmp-place-search truncation-preferred></gmp-place-search>
--gmp-button-border-color
لون حدود زر "الفتح في خرائط Google"
--gmp-button-border-radius
نصف قطر الحدود لزر "الفتح في خرائط Google"
--gmp-button-border-width
عرض الحدود لزر "فتح في خرائط Google"
--gmp-card-border-radius
نطاق الحدود لبطاقات الأماكن
--gmp-dialog-border-radius
نصف قطر الحدود لمربّع حوار الإفصاح في "خرائط Google"
--gmp-mat-color-info
لون عناصر واجهة المستخدم التي تحمل طابعًا إعلاميًا يُستخدَم لرمز المدخل المناسب للكراسي المتحركة.
--gmp-mat-color-negative
لون عناصر واجهة المستخدم التي تعبّر عن شعور سلبي يُستخدَم هذا التصنيف للإشارة إلى أنّ المكان "مغلق" في ساعات العمل.
--gmp-mat-color-neutral-container
لون الحاوية لعناصر واجهة المستخدم المعبأة بلون محايد تُستخدَم لشارات تاريخ المراجعة وتحميل أشكال العناصر النائبة.
--gmp-mat-color-on-neutral-container
لون النص والرموز على حاوية محايدة يُستخدَم لنص تاريخ المراجعة ونص خطأ التحميل.
--gmp-mat-color-on-secondary-container
لون النص والرموز مقابل لون الحاوية الثانوي يُستخدَم لنص الأزرار والرموز.
--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
لون تعبئة أقل بروزًا على سطح معيّن يُستخدَم لخلفيات الأزرار.
--gmp-mat-color-surface
لون الخلفيات يُستخدَم هذا اللون لخلفيات الحاويات ومربّعات الحوار.
--gmp-mat-font-body-small
يُستخدَم للحصول على معلومات عن المكان.
--gmp-mat-font-family
مجموعة الخطوط الأساسية لكل النصوص
--gmp-mat-font-headline-medium
يُستخدَم لعناوين مربّعات الحوار.
--gmp-mat-font-label-large
يُستخدَم لمحتوى الزر.
--gmp-mat-font-title-medium
يُستخدَم لاسم المكان.
--gmp-mat-spacing-extra-small
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-large
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-medium
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-mat-spacing-small
يُستخدَم للمسافات داخل العنصر، مثل الهامش والحشو حول النص.
--gmp-star-rating-color
لون النجوم الممتلئة في التقييم بالنجوم
--gmp-thumbnail-border-radius
نصف قطر الحدود للصورة المصغّرة للمكان
background-color
تلغي هذه السمة لون خلفية العنصر.
border
تتجاوز هذه السمة حدود العنصر.
border-radius
تتجاوز هذه السمة نصف قطر حدود العنصر.
color-scheme
يشير إلى نظام الألوان الذي يمكن عرض هذا العنصر به. لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات color-scheme. القيمة التلقائية هي color-scheme: light dark.
font-size
يغيّر حجم كل النصوص والرموز في العنصر. القيمة التلقائية هي 16px.
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي تريد إزالة متتبِّع الأحداث له.
  • ‫listener:  EventListener|EventListenerObject متتبِّع الأحداث الخاص بمعالج الأحداث المطلوب إزالته من هدف الحدث
  • ‫options:  boolean|EventListenerOptions optional يمكنك الاطّلاع على الخيارات.
القيمة المعروضة:  void
تزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener.
gmp-error
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عندما يتم رفض طلب إلى الخلفية (على سبيل المثال، مفتاح واجهة برمجة التطبيقات غير صحيح). لا يتصاعد هذا الحدث.
gmp-load
function(event)
الوسيطات: 
يتم بدء هذا الحدث عندما يحمّل العنصر محتواه ويعرضه. لا يتصاعد هذا الحدث.
gmp-select
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند اختيار مكان من القائمة. يحتوي على عنصر Place يتضمّن رقم التعريف والموقع الجغرافي وإطار العرض للمكان المحدّد.

PlaceSearchElementOptions

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

خيارات "PlaceSearchElement"
attributionPosition optional
النوع:  PlaceSearchAttributionPosition optional
يمكنك الاطّلاع على PlaceSearchElement.attributionPosition.
orientation optional
النوع:  PlaceSearchOrientation optional
يمكنك الاطّلاع على PlaceSearchElement.orientation.
selectable optional
النوع:  boolean optional
عرض PlaceSearchElement.selectable
truncationPreferred optional
النوع:  boolean optional
يمكنك الاطّلاع على PlaceSearchElement.truncationPreferred.

ثوابت PlaceSearchAttributionPosition

ذكرياتك الثابتة في شهر google.maps.places.PlaceSearchAttributionPosition

مواضع تحديد المصدر لـ "PlaceSearchElement"

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
BOTTOM مصدر البيانات في أسفل PlaceSearchElement
TOP مصدر البيانات في أعلى PlaceSearchElement

ثوابت PlaceSearchOrientation

ذكرياتك الثابتة في شهر google.maps.places.PlaceSearchOrientation

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

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

فئة PlaceSelectEvent

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

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

هذه الفئة هي امتداد لـ Event.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {PlaceSelectEvent} = await google.maps.importLibrary("places").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
place
النوع:  Place
المكان الذي تم اختياره

فئة PlaceNearbySearchRequestElement

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

يضبط هذا الإجراء PlaceSearchElement لتحميل النتائج استنادًا إلى طلب بحث في الجوار. يجب إدراج السمة locationRestriction ليتم تحميل عنصر البحث. وسيتم تجاهل أي سمات أخرى تم ضبطها في حال عدم ضبط locationRestriction. يمكنك إلحاق هذا العنصر كعنصر ثانوي لـ PlaceSearchElement من أجل تحميل النتائج. على سبيل المثال: 

 <gmp-place-search>
   <gmp-place-nearby-search-request
     location-restriction="RADIUS@LAT,LNG"
   ></gmp-place-nearby-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

العنصر المخصّص:
<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." excluded-types="excluded-type1 excluded-type2..." included-primary-types="included-primary-type1 included-primary-type2..." included-types="included-type1 included-type2..." location-restriction="radius@lat,lng" max-result-count="number" rank-preference="preference"></gmp-place-nearby-search-request>

هذه الفئة هي امتداد لـ HTMLElement.

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

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
PlaceNearbySearchRequestElement
PlaceNearbySearchRequestElement([options])
المَعلمات: 
excludedPrimaryTypes
النوع:  Array<string> optional
القيمة التلقائية: null
أنواع الأماكن الأساسية المستبعَدة
سمة HTML:
  • <gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>
excludedTypes
النوع:  Array<string> optional
القيمة التلقائية: null
أنواع الأماكن المستبعَدة
سمة HTML:
  • <gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>
includedPrimaryTypes
النوع:  Array<string> optional
القيمة التلقائية: null
نوع المكان الأساسي المضمّن
سمة HTML:
  • <gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>
includedTypes
النوع:  Array<string> optional
القيمة التلقائية: null
نوع المكان المضمّن
سمة HTML:
  • <gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>
locationRestriction
النوع:  Circle|CircleLiteral optional
القيمة التلقائية: null
تمثّل هذه السمة المنطقة المطلوب البحث فيها. يتم تطبيعها إلى Circle.
سمة HTML:
  • <gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>
maxResultCount
النوع:  number optional
القيمة التلقائية: null
تعرض هذه المَعلمة أكبر عدد ممكن من النتائج.
سمة HTML:
  • <gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>
rankPreference
النوع:  SearchNearbyRankPreference optional
القيمة التلقائية: null
كيفية ترتيب النتائج في الردّ
سمة HTML:
  • <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي تريد إزالة متتبِّع الأحداث له.
  • ‫listener:  EventListener|EventListenerObject متتبِّع الأحداث الخاص بمعالج الأحداث المطلوب إزالته من هدف الحدث
  • ‫options:  boolean|EventListenerOptions optional يمكنك الاطّلاع على الخيارات.
القيمة المعروضة:  void
تزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener.

واجهة PlaceNearbySearchRequestElementOptions

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

خيارات "PlaceNearbySearchRequestElement"
excludedPrimaryTypes optional
النوع:  Array<string> optional
أنواع الأماكن الأساسية المستبعَدة لمزيد من التفاصيل، يُرجى الاطّلاع على PlaceNearbySearchRequestElement.excludedPrimaryTypes وSearchNearbyRequest.excludedPrimaryTypes.
excludedTypes optional
النوع:  Array<string> optional
أنواع الأماكن المستبعَدة لمزيد من التفاصيل، يُرجى الاطّلاع على PlaceNearbySearchRequestElement.excludedTypes وSearchNearbyRequest.excludedTypes.
includedPrimaryTypes optional
النوع:  Array<string> optional
أنواع الأماكن الأساسية المضمّنة لمزيد من التفاصيل، يُرجى الاطّلاع على PlaceNearbySearchRequestElement.includedPrimaryTypes وSearchNearbyRequest.includedPrimaryTypes.
includedTypes optional
النوع:  Array<string> optional
أنواع الأماكن المضمّنة لمزيد من التفاصيل، يُرجى الاطّلاع على PlaceNearbySearchRequestElement.includedTypes وSearchNearbyRequest.includedTypes.
locationRestriction optional
النوع:  Circle|CircleLiteral optional
تمثّل هذه السمة المنطقة المطلوب البحث فيها. لمزيد من التفاصيل، يُرجى الاطّلاع على PlaceNearbySearchRequestElement.locationRestriction وSearchNearbyRequest.locationRestriction.
maxResultCount optional
النوع:  number optional
تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. لمزيد من التفاصيل، يُرجى الاطّلاع على PlaceNearbySearchRequestElement.maxResultCount وSearchNearbyRequest.maxResultCount.
rankPreference optional
النوع:  SearchNearbyRankPreference optional
كيفية ترتيب النتائج في الردّ لمزيد من التفاصيل، يُرجى الاطّلاع على PlaceNearbySearchRequestElement.rankPreference وSearchNearbyRankPreference.

PlaceTextSearchRequestElement class

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

يضبط هذا الإجراء PlaceSearchElement لتحميل النتائج استنادًا إلى طلب بحث نصي. يجب إدراج السمة textQuery ليتم تحميل عنصر البحث. وسيتم تجاهل أي سمات أخرى تم ضبطها في حال عدم ضبط textQuery. يمكنك إلحاق هذا العنصر كعنصر ثانوي لـ PlaceSearchElement من أجل تحميل النتائج. على سبيل المثال: 

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

العنصر المخصّص:
<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..." ev-minimum-charging-rate-kw="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

هذه الفئة هي امتداد لـ HTMLElement.

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

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
PlaceTextSearchRequestElement
PlaceTextSearchRequestElement([options])
المَعلمات: 
evConnectorTypes
النوع:  Array<EVConnectorType> optional
القيمة التلقائية: null
قائمة بأنواع وصلات المركبات الكهربائية المفضّلة
سمة HTML:
  • <gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>
evMinimumChargingRateKw
النوع:  number optional
القيمة التلقائية: null
الحدّ الأدنى المطلوب لمعدّل الشحن بالكيلوواط
سمة HTML:
  • <gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>
includedType
النوع:  string optional
القيمة التلقائية: null
نوع المكان المطلوب
سمة HTML:
  • <gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>
isOpenNow
النوع:  boolean optional
القيمة التلقائية: null
يُستخدَم لحصر البحث في الأماكن المفتوحة حاليًا.
سمة HTML:
  • <gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>
locationBias
النوع:  LocationBias optional
القيمة التلقائية: null
الانحياز للموقع الجغرافي في البحث يتم تطبيعها إلى LatLngAltitude | LatLngBounds | Circle | string.
سمة HTML:
  • <gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>
locationRestriction
النوع:  LatLngBounds|LatLngBoundsLiteral optional
القيمة التلقائية: null
قيد الموقع الجغرافي للبحث يتم تطبيعها إلى LatLngBounds.
سمة HTML:
  • <gmp-place-text-search-request location-restriction="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
maxResultCount
النوع:  number optional
القيمة التلقائية: null
تعرض هذه المَعلمة أكبر عدد ممكن من النتائج.
سمة HTML:
  • <gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>
minRating
النوع:  number optional
القيمة التلقائية: null
تصفية النتائج التي يكون متوسط تقييم المستخدمين لها أقل من هذا الحدّ
سمة HTML:
  • <gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>
priceLevels
النوع:  Array<PriceLevel> optional
القيمة التلقائية: null
يُستخدَم هذا المعيار لحصر البحث في الأماكن التي تم وضع علامة عليها كمستويات أسعار معيّنة.
سمة HTML:
  • <gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>
rankPreference
النوع:  SearchByTextRankPreference optional
القيمة التلقائية: null
كيفية ترتيب النتائج في الردّ
سمة HTML:
  • <gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>
textQuery
النوع:  string optional
القيمة التلقائية: null
طلب البحث النصي للبحث النصي
سمة HTML:
  • <gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>
useStrictTypeFiltering
النوع:  boolean optional
القيمة التلقائية: null
يُستخدَم لضبط فلترة صارمة للنوع في 'includedType'.
سمة HTML:
  • <gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي تريد إزالة متتبِّع الأحداث له.
  • ‫listener:  EventListener|EventListenerObject متتبِّع الأحداث الخاص بمعالج الأحداث المطلوب إزالته من هدف الحدث
  • ‫options:  boolean|EventListenerOptions optional يمكنك الاطّلاع على الخيارات.
القيمة المعروضة:  void
تزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener.

واجهة PlaceTextSearchRequestElementOptions

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

خيارات "PlaceTextSearchRequestElement"
evConnectorTypes optional
النوع:  Array<EVConnectorType> optional
قائمة بأنواع وصلات المركبات الكهربائية المفضّلة لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.evSearchOptions وPlaceTextSearchRequestElement.evConnectorTypes.
evMinimumChargingRateKw optional
النوع:  number optional
الحدّ الأدنى المطلوب لمعدّل الشحن بالكيلوواط لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.evSearchOptions وPlaceTextSearchRequestElement.evMinimumChargingRateKw.
includedType optional
النوع:  string optional
نوع المكان المطلوب لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.includedType وPlaceTextSearchRequestElement.includedType.
isOpenNow optional
النوع:  boolean optional
يُستخدَم لحصر البحث في الأماكن المفتوحة حاليًا. لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.isOpenNow وPlaceTextSearchRequestElement.isOpenNow.
locationBias optional
النوع:  LocationBias optional
الانحياز للموقع الجغرافي في البحث لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.locationBias وPlaceTextSearchRequestElement.locationBias.
locationRestriction optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
قيد الموقع الجغرافي للبحث لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.locationRestriction وPlaceTextSearchRequestElement.locationRestriction.
maxResultCount optional
النوع:  number optional
تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.maxResultCount وPlaceTextSearchRequestElement.maxResultCount.
minRating optional
النوع:  number optional
تصفية النتائج التي يكون متوسط تقييم المستخدمين لها أقل من هذا الحدّ لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.minRating وPlaceTextSearchRequestElement.minRating.
priceLevels optional
النوع:  Array<PriceLevel> optional
يُستخدَم هذا المعيار لحصر البحث في الأماكن التي تم وضع علامة عليها كمستويات أسعار معيّنة. لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.priceLevels وPlaceTextSearchRequestElement.priceLevels.
rankPreference optional
النوع:  SearchByTextRankPreference optional
كيفية ترتيب النتائج في الردّ لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.rankPreference وPlaceTextSearchRequestElement.rankPreference.
textQuery optional
النوع:  string optional
طلب البحث النصي للبحث النصي لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.textQuery وPlaceTextSearchRequestElement.textQuery.
useStrictTypeFiltering optional
النوع:  boolean optional
يُستخدَم لضبط فلترة صارمة للنوع في SearchByTextRequest.includedType. لمزيد من التفاصيل، يُرجى الاطّلاع على SearchByTextRequest.useStrictTypeFiltering وPlaceTextSearchRequestElement.useStrictTypeFiltering.

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

صف واحد (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 المكان الذي اختاره المستخدم.
تعرض هذه الدالة تفاصيل المكان الذي اختاره المستخدم إذا تم استرداد التفاصيل بنجاح. وإلا، يتم عرض عنصر "مكان" بديل، مع ضبط السمة name على القيمة الحالية لحقل الإدخال.
setBounds
setBounds(bounds)
المَعلمات: 
القيمة المعروضة:  لا شيء
تحدّد هذه المَعلمة المنطقة المفضّلة لعرض نتائج الأماكن ضمنها. تكون النتائج منحازة إلى هذه المنطقة، ولكنّها لا تقتصر عليها.
setComponentRestrictions
setComponentRestrictions(restrictions)
المَعلمات: 
  • ‫restrictions:  ComponentRestrictions optional القيود المفروضة على الاستخدام
القيمة المعروضة:  لا شيء
يضبط هذا الإجراء قيود المكوّنات. تُستخدَم قيود المكوّنات لحصر التوقّعات على تلك الموجودة ضمن المكوّن الرئيسي. على سبيل المثال، البلد.
setFields
setFields(fields)
المَعلمات: 
  • fields:  Array<string> optional
القيمة المعروضة:  لا شيء
يحدّد الحقول التي سيتم تضمينها للمكان في ردّ التفاصيل عند استرداد التفاصيل بنجاح. للاطّلاع على قائمة بالحقول، يُرجى مراجعة PlaceResult.
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
setTypes
setTypes(types)
المَعلمات: 
  • ‫types:  Array<string> optional أنواع عبارات البحث المقترَحة التي سيتم تضمينها.
القيمة المعروضة:  لا شيء
يتم ضبط أنواع التوقّعات التي سيتم عرضها. للاطّلاع على الأنواع المتوافقة، يُرجى مراجعة دليل المطوّر. وفي حال عدم تحديد أي أنواع، سيتم عرض جميع الأنواع.
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
place_changed
function()
الوسيطات:  لا تتوفّر أي وسيطات
يتم تنشيط هذا الحدث عندما يصبح PlaceResult متاحًا لمكان اختاره المستخدم.
إذا أدخل المستخدم اسم مكان لم يقترحه عنصر التحكّم وضغط على مفتاح Enter، أو إذا تعذّر تنفيذ طلب "تفاصيل المكان"، يحتوي PlaceResult على إدخال المستخدم في السمة name، بدون تحديد أي سمات أخرى.

واجهة 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 إلا على حقول رقم تعريف المكان وtypes وname، مع عرض رقم تعريف المكان و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 interface

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

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

فئة PlaceContextualElement

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

تستخدم هذه الأداة الرمز المميّز السياقي لعرض ردّ "استخدام خرائط Google كمصدر" بشكل سياقي.

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

هذه الفئة هي امتداد لـ HTMLElement.

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

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {PlaceContextualElement} = await google.maps.importLibrary("places").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
PlaceContextualElement
PlaceContextualElement([options])
المَعلمات: 
contextToken
النوع:  string optional
الرمز المميّز السياقي
سمة HTML:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي تريد إزالة متتبِّع الأحداث له.
  • ‫listener:  EventListener|EventListenerObject متتبِّع الأحداث الخاص بمعالج الأحداث المطلوب إزالته من هدف الحدث
  • ‫options:  boolean|EventListenerOptions optional يمكنك الاطّلاع على الخيارات.
القيمة المعروضة:  void
تزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener.

PlaceContextualElementOptions

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

خيارات "PlaceContextualElement"
contextToken optional
النوع:  string optional
الرمز المميّز السياقي الذي يوفّره ردّ ميزة "استخدام خرائط Google كمصدر".

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.
PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
المَعلمات: 
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>
addEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive.
القيمة المعروضة:  void
يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • ‫type:  string سلسلة تحدّد نوع الحدث الذي تريد إزالة متتبِّع الأحداث له.
  • ‫listener:  EventListener|EventListenerObject متتبِّع الأحداث الخاص بمعالج الأحداث المطلوب إزالته من هدف الحدث
  • ‫options:  boolean|EventListenerOptions optional يمكنك الاطّلاع على الخيارات.
القيمة المعروضة:  void
تزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener.

PlaceContextualListConfigElementOptions interface

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

خيارات PlaceContextualListConfigElement.
layout optional
النوع:  PlaceContextualListLayout optional
القيمة التلقائية: PlaceContextualListLayout.VERTICAL
التنسيق:
mapHidden optional
النوع:  boolean optional
القيمة التلقائية: false
"صحيح" إذا كان يجب إخفاء الخريطة

ثوابت PlaceContextualListLayout

ذكرياتك الثابتة في شهر google.maps.places.PlaceContextualListLayout

قائمة التنسيقات التي يتيحها "عنصر سياق المكان" للعرض على شكل قائمة.

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