Places Widgets

فئة BasicPlaceAutocompleteElement

google.maps.places.BasicPlaceAutocompleteElement صف

‫BasicPlaceAutocompleteElement هي فئة فرعية من HTMLElement توفّر مكوّن واجهة مستخدم لواجهة Places Autocomplete 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) المَعلمات:  options:  BasicPlaceAutocompleteElementOptions

الخصائص
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	النوع:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional نقطة البداية التي سيتم حساب المسافة منها. إذا لم يتم تحديدها، لن يتم احتساب المسافة. لا يتم استخدام الارتفاع في عملية الاحتساب، إذا تم توفيره. سمة 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 ("نطاق المستوى الأعلى") مكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز ccTLD الخاص بالمملكة المتحدة هو "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> واحدًا بالضبط ليتم عرضه كرمز بجانب عنصر التوقّع.

الأجزاء
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.

خصائص CSS
background-color	تتجاوز هذه السمة لون الخلفية للعنصر.
border	تستبدل هذه السمة حدود العنصر.
border-radius	تتجاوز هذه السمة نصف قطر حدود العنصر.
color-scheme	تشير إلى نظام الألوان الذي يمكن عرض هذا العنصر به. لمزيد من التفاصيل، يمكنك الاطّلاع على color-scheme المستندات. القيمة التلقائية هي color-scheme: light dark.

الطُرق
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) الوسيطات:  errorEvent:  Event يتم إطلاق هذا الحدث عندما يتم رفض طلب إلى الخلفية (مثل مفتاح واجهة برمجة تطبيقات غير صحيح). لا يظهر هذا الحدث.
gmp-select	function(placeSelectEvent) الوسيطات:  placeSelectEvent:  PlaceSelectEvent يتم تنشيط هذا الحدث عندما يختار المستخدم توقّعًا لمكان. يحتوي على عنصر "مكان".

BasicPlaceAutocompleteElementOptions interface

google.maps.places.BasicPlaceAutocompleteElementOptions interface

خيارات لإنشاء 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	النوع:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
requestedLanguage optional	النوع:  string optional
requestedRegion optional	النوع:  string optional
unitSystem optional	النوع:  UnitSystem optional

فئة 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) المَعلمات:  options:  PlaceAutocompleteElementOptions

الخصائص
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	النوع:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional نقطة البداية التي سيتم حساب المسافة منها. إذا لم يتم تحديدها، لن يتم احتساب المسافة. لا يتم استخدام الارتفاع في عملية الاحتساب، إذا تم توفيره. سمة 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.

خصائص CSS
background-color	تتجاوز هذه السمة لون الخلفية للعنصر.
border	تستبدل هذه السمة حدود العنصر.
border-radius	تتجاوز هذه السمة نصف قطر حدود العنصر.
color-scheme	تشير إلى نظام الألوان الذي يمكن عرض هذا العنصر به. لمزيد من التفاصيل، يمكنك الاطّلاع على color-scheme المستندات. القيمة التلقائية هي color-scheme: light dark.

الطُرق
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) الوسيطات:  errorEvent:  Event يتم إطلاق هذا الحدث عندما يتم رفض طلب إلى الخلفية (مثل مفتاح واجهة برمجة تطبيقات غير صحيح). لا يظهر هذا الحدث.
gmp-select	function(placePredictionSelectEvent) الوسيطات:  placePredictionSelectEvent:  PlacePredictionSelectEvent يتم تنشيط هذا الحدث عندما يختار المستخدم توقّعًا لمكان. يحتوي على عنصر PlacePrediction يمكن تحويله إلى عنصر Place.

PlaceAutocompleteElementOptions interface

google.maps.places.PlaceAutocompleteElementOptions interface

خيارات إنشاء 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	النوع:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
requestedLanguage optional	النوع:  string optional
requestedRegion optional	النوع:  string optional
unitSystem optional	النوع:  UnitSystem 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 صف

تم إيقافها نهائيًا: سيستمرّ الحدث gmp-requesterror في التشغيل في القناة التجريبية، ولكن لن يتم تشغيله في الإصدار الأوّلي أو عند الإصدار. لأغراض نقل البيانات، واصِل معالجة الحدث gmp-requesterror، ولكن أضِف أيضًا أداة معالجة الحدث gmp-error التي تعرض العنصر Event.

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط.

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

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

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

فئة PlaceContextualElement

google.maps.places.PlaceContextualElement صف

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=alpha فقط.

أداة تستخدم رمز السياق لعرض طريقة عرض سياقية لردّ 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.

الشركة المصنِّعة
PlaceContextualElement	PlaceContextualElement([options]) المَعلمات:  options:  PlaceContextualElementOptions optional

الخصائص
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 interface

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=alpha فقط.

خيارات PlaceContextualElement

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

PlaceContextualListConfigElement class

google.maps.places.PlaceContextualListConfigElement صف

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=alpha فقط.

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

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

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

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

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

الشركة المصنِّعة
PlaceContextualListConfigElement	PlaceContextualListConfigElement([options]) المَعلمات:  options:  PlaceContextualListConfigElementOptions optional

الخصائص
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>
mapMode	النوع:  PlaceContextualListMapMode optional وضع الخريطة المستخدَم في "عنصر السياق الخاص بالمكان" لقائمة الأماكن سمة HTML: <gmp-place-contextual-list-config map-mode="none"></gmp-place-contextual-list-config> <gmp-place-contextual-list-config map-mode="roadmap"></gmp-place-contextual-list-config> <gmp-place-contextual-list-config map-mode="hybrid"></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 interface

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=alpha فقط.

خيارات PlaceContextualListConfigElement

الخصائص
layout optional	النوع:  PlaceContextualListLayout optional القيمة التلقائية: PlaceContextualListLayout.VERTICAL التنسيق
mapHidden optional	النوع:  boolean optional القيمة التلقائية: false يتم ضبط القيمة على "صحيح" إذا كان من المفترض إخفاء الخريطة.
mapMode optional	النوع:  PlaceContextualListMapMode optional القيمة التلقائية: PlaceContextualListMapMode.ROADMAP وضع الخريطة المستخدَم في "عنصر السياق الخاص بالمكان" لقائمة الأماكن

PlaceContextualListLayout constants

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

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=alpha فقط.

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

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

الثوابت
COMPACT	تنسيق القائمة المختصرة: يتم عرض عناصر القائمة كروابط على سطر واحد، مع عرض العناصر الزائدة في قائمة منسدلة.
VERTICAL	تخطيط القائمة العمودية: يتم عرض عناصر القائمة على شكل بطاقات في قائمة عمودية.

PlaceContextualListMapMode الثوابت

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

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=alpha فقط.

وضع الخريطة المستخدَم في "عنصر السياق الخاص بالمكان" لقائمة الأماكن

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

الثوابت
HYBRID	طبقة شفافة من الشوارع الرئيسية على صور القمر الصناعي أو صور واقعية ثلاثية الأبعاد
NONE	ما مِن خريطة.
ROADMAP	خريطة شوارع عادية ثنائية الأبعاد

PlaceDetailsElementPlaceDetailsElement

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> 

لاستخدام هذا العنصر، فعِّل Places UI Kit 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]) المَعلمات:  options:  PlaceDetailsElementOptions optional

الخصائص
place	النوع:  Place optional للقراءة فقط عنصر المكان الذي يحتوي على المعرّف والموقع الجغرافي ونافذة العرض للمكان المعروض حاليًا

خصائص CSS
--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	يُستخدَم لعرض عنوان المكان وتقييمه ونوعه وسعره وحالة "مفتوح الآن" وساعات العمل والمراجعات ورقم الهاتف والموقع الإلكتروني والرمز البريدي ونصوص الميزات الرئيسية ونص الرسالة في مربّع الحوار الخاص ببيانات الإفصاح في "خرائط 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) الوسيطات:  event:  Event يتم إطلاق هذا الحدث عندما يتم رفض طلب إلى الخلفية (مثل مفتاح واجهة برمجة تطبيقات غير صحيح). لا يظهر هذا الحدث.
gmp-load	function(event) الوسيطات:  event:  Event يتم تنشيط هذا الحدث عندما يتم تحميل العنصر وعرض محتواه. لا يظهر هذا الحدث.

PlaceDetailsElementOptions interface

google.maps.places.PlaceDetailsElementOptions interface

خيارات PlaceDetailsElement

PlaceDetailsCompactElementPlaceDetailsCompactElement

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> 

لاستخدام هذا العنصر، فعِّل 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]) المَعلمات:  options:  PlaceDetailsCompactElementOptions optional

الخصائص
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>

خصائص CSS
--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) الوسيطات:  event:  Event يتم إطلاق هذا الحدث عندما يتم رفض طلب إلى الخلفية (مثل مفتاح واجهة برمجة تطبيقات غير صحيح). لا يظهر هذا الحدث.
gmp-load	function(event) الوسيطات:  event:  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 أو 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]) المَعلمات:  options:  PlaceDetailsPlaceRequestElementOptions optional

الخصائص
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 interface

google.maps.places.PlaceDetailsPlaceRequestElementOptions interface

خيارات PlaceDetailsPlaceRequestElement

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

PlaceDetailsLocationRequestElement class

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]) المَعلمات:  options:  PlaceDetailsLocationRequestElementOptions optional

الخصائص
location	النوع:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional القيمة التلقائية: 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 interface

خيارات PlaceDetailsLocationRequestElement

الخصائص
location optional	النوع:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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]) المَعلمات:  options:  PlaceSearchElementOptions optional

الخصائص
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>

خصائص CSS
--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) الوسيطات:  event:  Event يتم إطلاق هذا الحدث عندما يتم رفض طلب إلى الخلفية (مثل مفتاح واجهة برمجة تطبيقات غير صحيح). لا يظهر هذا الحدث.
gmp-load	function(event) الوسيطات:  event:  Event يتم تنشيط هذا الحدث عندما يتم تحميل العنصر وعرض محتواه. لا يظهر هذا الحدث.
gmp-select	function(event) الوسيطات:  event:  PlaceSelectEvent يتم تنشيط هذا الحدث عند اختيار مكان من القائمة. يحتوي على عنصر Place يتضمّن رقم التعريف والموقع الجغرافي ونافذة العرض للمكان المحدّد.

PlaceSearchElementOptions interface

google.maps.places.PlaceSearchElementOptions interface

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

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]) المَعلمات:  options:  PlaceNearbySearchRequestElementOptions optional

الخصائص
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 سمة 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 interface

google.maps.places.PlaceNearbySearchRequestElementOptions interface

خيارات 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]) المَعلمات:  options:  PlaceTextSearchRequestElementOptions optional

الخصائص
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	النوع:  string|LatLngAltitude|LatLngBounds|Circle|LatLng|LatLngLiteral|LatLngAltitudeLiteral|LatLngBoundsLiteral|CircleLiteral optional القيمة التلقائية: null سمة 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 سمة 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 سمة 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 interface

google.maps.places.PlaceTextSearchRequestElementOptions interface

خيارات 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	النوع:  string|LatLngAltitude|LatLngBounds|Circle|LatLng|LatLngLiteral|LatLngAltitudeLiteral|LatLngBoundsLiteral|CircleLiteral 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 صف

إيقاف نهائي: اعتبارًا من 1 مارس 2025، لن تكون خدمة google.maps.places.Autocomplete متاحة للعملاء الجدد. يُرجى استخدام PlaceAutocompleteElement بدلاً من ذلك. في الوقت الحالي، ليس من المقرر إيقاف google.maps.places.Autocomplete نهائيًا، ولكن يُنصح باستخدام PlaceAutocompleteElement بدلاً من google.maps.places.Autocomplete. مع أنّ خدمة google.maps.places.Autocomplete ستستمر في تلقّي إصلاحات الأخطاء لأي تراجعات كبيرة، لن يتم حلّ الأخطاء الحالية في google.maps.places.Autocomplete. سيتم إرسال إشعار قبل 12 شهرًا على الأقل من إيقاف الدعم. يُرجى الاطّلاع على https://developers.google.com/maps/legacy للحصول على تفاصيل إضافية، وعلى https://developers.google.com/maps/documentation/javascript/places-migration-overview للاطّلاع على دليل نقل البيانات.

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

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

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

الشركة المصنِّعة
Autocomplete	Autocomplete(inputField[, opts]) المَعلمات:  inputField:  HTMLInputElement حقل النص <input> الذي يجب إرفاق Autocomplete به. opts:  AutocompleteOptions optional خيارات تنشئ هذه الدالة مثيلاً جديدًا من Autocomplete يتم إرفاقه بحقل الإدخال النصي المحدّد مع الخيارات المحدّدة.

الطُرق
getBounds	getBounds() المَعلمات:  بدون قيمة الإرجاع:  LatLngBounds|undefined حدود التحيز. تعرِض هذه السمة الحدود التي يتم فيها تحيز التوقعات.
getFields	getFields() المَعلمات:  بدون قيمة العائد:  Array<string>|undefined تعرض هذه السمة الحقول التي سيتم تضمينها في استجابة التفاصيل عند استرداد التفاصيل بنجاح. للاطّلاع على قائمة بالحقول، يُرجى الانتقال إلى PlaceResult.
getPlace	getPlace() المَعلمات:  بدون قيمة الإرجاع:  PlaceResult المكان الذي اختاره المستخدم. تعرض هذه السمة تفاصيل المكان الذي اختاره المستخدم إذا تم استرداد التفاصيل بنجاح. بخلاف ذلك، يتم عرض عنصر Place زائف، مع ضبط السمة name على القيمة الحالية لحقل الإدخال.
setBounds	setBounds(bounds) المَعلمات:  ‫bounds:  LatLngBounds|LatLngBoundsLiteral optional حدود التحيز القيمة المعروضة:  لا شيء تضبط هذه السمة المنطقة المفضّلة التي سيتم عرض نتائج الأماكن ضمنها. تكون النتائج متحيزة لهذه المنطقة، ولكنّها لا تقتصر عليها.
setComponentRestrictions	setComponentRestrictions(restrictions) المَعلمات:  restrictions:  ComponentRestrictions optional القيود المفروضة على الاستخدام القيمة المعروضة:  لا شيء تضبط هذه السمة قيود المكوّن. تُستخدَم قيود المكوّنات لحصر التوقّعات على تلك التي تقع ضمن المكوّن الرئيسي فقط. على سبيل المثال، البلد.
setFields	setFields(fields) المَعلمات:  fields:  Array<string> optional القيمة المعروضة:  لا شيء تضبط هذه السمة الحقول التي سيتم تضمينها في استجابة التفاصيل عند استرداد التفاصيل بنجاح. للاطّلاع على قائمة بالحقول، يُرجى الانتقال إلى PlaceResult.
setOptions	setOptions(options) المَعلمات:  options:  AutocompleteOptions optional القيمة المعروضة:  لا شيء
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	متوقّفة نهائيًا: تم إيقاف placeIdOnly نهائيًا اعتبارًا من 15 كانون الثاني (يناير) 2019، وسيتم إيقافها في 15 كانون الثاني (يناير) 2020. استخدِم AutocompleteOptions.fields بدلاً من ذلك: fields: ['place_id', 'name', 'types']. النوع:  boolean optional تحديد ما إذا كان سيتم استرداد معرّفات الأماكن فقط لن يتضمّن PlaceResult المتاح عند تشغيل حدث place_changed سوى الحقول place_id وtypes وname، مع عرض place_id وtypes وdescription التي تعرضها خدمة الإكمال التلقائي. يتم إيقافها تلقائيًا.
strictBounds optional	النوع:  boolean optional قيمة منطقية تشير إلى أنّه يجب أن تعرض أداة الإكمال التلقائي الأماكن التي تقع ضمن حدودها فقط عند إرسال طلب البحث. سيؤدي ضبط strictBounds على false (وهو الإعداد التلقائي) إلى تحيّز النتائج نحو الأماكن التي تقع ضمن الحدود، ولكن لن يقتصر عليها.
types optional	النوع:  Array<string> optional تمثّل هذه السمة أنواع التوقّعات المطلوب عرضها. للاطّلاع على الأنواع المتوافقة، يُرجى الرجوع إلى دليل المطوِّر. في حال عدم تحديد أي أنواع، سيتم عرض جميع الأنواع.

فئة SearchBox

google.maps.places.SearchBox صف

تم إيقافها نهائيًا: اعتبارًا من 1 مارس 2025، لن تكون google.maps.places.SearchBox متاحة للعملاء الجدد. في الوقت الحالي، ليس من المقرر إيقاف google.maps.places.SearchBox نهائيًا، وسيستمر تلقّي إصلاحات الأخطاء لأي تراجع كبير. سيتم إرسال إشعار قبل 12 شهرًا على الأقل من إيقاف الدعم. يُرجى الاطّلاع على https://developers.google.com/maps/legacy للحصول على مزيد من التفاصيل.

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

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

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

الشركة المصنِّعة
SearchBox	SearchBox(inputField[, opts]) المَعلمات:  inputField:  HTMLInputElement opts:  SearchBoxOptions optional تنشئ هذه الدالة مثيلاً جديدًا من SearchBox يتم إرفاقه بحقل الإدخال النصي المحدّد مع الخيارات المحدّدة.

الطُرق
getBounds	getBounds() المَعلمات:  بدون قيمة العائد:  LatLngBounds|undefined تعرض هذه السمة الحدود التي يتم فيها تحيز عبارات البحث المقترَحة.
getPlaces	getPlaces() المَعلمات:  بدون قيمة العائد:  Array<PlaceResult>|undefined تعرِض طلب البحث الذي اختاره المستخدِم لاستخدامه مع الحدث places_changed.
setBounds	setBounds(bounds) المَعلمات:  bounds:  LatLngBounds|LatLngBoundsLiteral optional القيمة المعروضة:  لا شيء تضبط هذه السمة المنطقة التي سيتم استخدامها لتحديد توقّعات طلب البحث. ستكون النتائج متحيزة لهذه المنطقة فقط، ولن تقتصر عليها تمامًا.
موروثة: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

الفعاليات
places_changed	function() الوسيطات:  لا شيء يتم تشغيل هذا الحدث عندما يختار المستخدم طلب بحث، ويجب استخدام getPlaces للحصول على أماكن جديدة.

واجهة SearchBoxOptions

google.maps.places.SearchBoxOptions interface

الخيارات التي يمكن ضبطها على عنصر SearchBox

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