Place Widget Content Customization

PlaceContentConfigElement class

class google.maps.places.PlaceContentConfigElement extends HTMLElement implements PlaceContentConfigElementOptions
library "places"

يتم ضبط PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement لعرض مجموعة مخصّصة من المحتوى. يجب إلحاق هذا العنصر كعنصر ثانوي لاستخدامه.

بالنسبة إلى PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement، أضِف أيًا من العناصر التالية إلى PlaceContentConfigElement لعرض المحتوى المقابل:
PlaceAddressElement وPlaceAccessibleEntranceIconElement وPlaceAttributionElement PlaceMediaElement وPlaceOpenNowStatusElement وPlacePriceElement وPlaceRatingElement وPlaceTypeElement.

بالنسبة إلى PlaceDetailsElement، يمكنك أيضًا إلحاق أي من العناصر التالية:
PlaceFeatureListElement PlaceOpeningHoursElement وPlacePhoneNumberElement وPlacePlusCodeElement وPlaceReviewSummaryElement وPlaceReviewsElement وPlaceSummaryElement وPlaceTypeSpecificHighlightsElement وPlaceWebsiteElement.

لا يهم ترتيب العناصر الفرعية، لأنّ العنصر يعرض المحتوى بترتيب عادي لا يمكن تخصيصه. مثال:

 <gmp-place-details>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
    <gmp-place-address></gmp-place-address>
  </gmp-place-content-config>
</gmp-place-details>

<gmp-place-content-config></gmp-place-content-config>
const {PlaceContentConfigElement} = await google.maps.importLibrary("places");
PlaceContentConfigElement
PlaceContentConfigElement([options])
المَعلمات:
السمات المكتسَبة: addEventListener، removeEventListener

<thought واجهة PlaceContentConfigElementOptions

interface google.maps.places.PlaceContentConfigElementOptions
implemented by PlaceContentConfigElement

خيارات "PlaceContentConfigElement"

فئة PlaceAllContentElement

class google.maps.places.PlaceAllContentElement extends HTMLElement implements PlaceAllContentElementOptions
library "places"

يتم ضبط PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement لعرض كل المحتوى المتاح. يجب إلحاق هذا العنصر كعنصر ثانوي لاستخدامه. على سبيل المثال:

 <gmp-place-details>
  <gmp-place-all-content></gmp-place-all-content>
</gmp-place-details>

<gmp-place-all-content></gmp-place-all-content>
const {PlaceAllContentElement} = await google.maps.importLibrary("places");
PlaceAllContentElement
PlaceAllContentElement([options])
المَعلمات:
السمات المكتسَبة: addEventListener، removeEventListener

PlaceAllContentElementOptions interface

interface google.maps.places.PlaceAllContentElementOptions
implemented by PlaceAllContentElement

خيارات "PlaceAllContentElement"

PlaceStandardContentElement class

class google.maps.places.PlaceStandardContentElement extends HTMLElement implements PlaceStandardContentElementOptions
library "places"

يتم ضبط PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement لعرض مجموعة معايير التعلُّم من المحتوى. يجب إلحاق هذا العنصر كعنصر ثانوي لاستخدامه.
بالنسبة إلى PlaceDetailsElement، يتألف المحتوى العادي مما يلي:

  • وسائط
  • معالجة
  • rating
  • النوع
  • price
  • رمز مدخل مناسب لذوي الاحتياجات الخاصة
  • الموقع الإلكتروني
  • رقم الهاتف
  • ساعات العمل
  • ملخّص
  • أبرز الميزات الخاصة بالنوع
  • مُراجعات
  • قائمة الميزات

بالنسبة إلى PlaceDetailsCompactElement، يتألف المحتوى العادي مما يلي:
  • وسائط
  • rating
  • النوع
  • price
  • رمز مدخل مناسب لذوي الاحتياجات الخاصة
  • حالة "مفتوح الآن"

بالنسبة إلى PlaceSearchElement، يتألف المحتوى العادي مما يلي:
  • وسائط
  • rating
  • النوع
  • price
  • رمز مدخل مناسب لذوي الاحتياجات الخاصة

على سبيل المثال:
 <gmp-place-details>
  <gmp-place-standard-content></gmp-place-standard-content>
</gmp-place-details>

<gmp-place-standard-content></gmp-place-standard-content>
const {PlaceStandardContentElement} = await google.maps.importLibrary("places");
PlaceStandardContentElement
PlaceStandardContentElement([options])
المَعلمات:
السمات المكتسَبة: addEventListener، removeEventListener

PlaceStandardContentElementOptions interface

interface google.maps.places.PlaceStandardContentElementOptions
implemented by PlaceStandardContentElement

خيارات "PlaceStandardContentElement"

PlaceMediaElement class

class google.maps.places.PlaceMediaElement extends HTMLElement implements PlaceMediaElementOptions
library "places"

تضبط هذه السمة PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement لعرض وسائط مكان معيّن، مثل الصور. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-media lightbox-preferred></gmp-place-media>
</gmp-place-content-config>

<gmp-place-media
  lightbox-preferred
  preferred-size="value-name">
</gmp-place-media>
const {PlaceMediaElement} = await google.maps.importLibrary("places");
PlaceMediaElement
PlaceMediaElement([options])
المَعلمات:
lightboxPreferred
attr: lightbox-preferred
نوع الإدخال: boolean optional
نوع الإخراج: boolean
القيمة التلقائية: false
تحدّد ما إذا كان سيتم تفعيل ميزة "العرض المبسّط للوسائط" أو إيقافها، في الحالات التي يتوفّر فيها كلا الخيارَين.
سمة HTML: lightbox-preferred
preferredSize
attr: preferred-size
نوع الإدخال: MediaSize optional
نوع الإخراج: MediaSize optional
القيمة التلقائية: null
حجم الوسائط المفضّل في الحالات التي تتوفّر فيها أحجام متعددة، مثل PlaceSearchElement العمودي سيستخدم المجال الرأسي PlaceSearchElement السمة MediaSize.SMALL تلقائيًا في حال عدم تحديدها.
سمة HTML: preferred-size="value-name"
السمات المكتسَبة: addEventListener، removeEventListener

PlaceMediaElementOptions interface

interface google.maps.places.PlaceMediaElementOptions
implemented by PlaceMediaElement

خيارات "PlaceMediaElement"

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

ثوابت MediaSize

ثوابت google.maps.places.MediaSize
مكتبة "places"

حجم الوسائط المفضّل في الحالات التي تتوفّر فيها أحجام متعددة، مثل PlaceSearchElement العمودي

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع MediaSizeString.

const {MediaSize} = await google.maps.importLibrary("places");
LARGE حجم ملف الوسائط كبير.
MEDIUM حجم وسائط متوسط
SMALL حجم الوسائط صغير.

فئة PlaceAddressElement

class google.maps.places.PlaceAddressElement extends HTMLElement implements PlaceAddressElementOptions
library "places"

تضبط هذه السمة PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement لعرض عنوان مكان معيّن. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-address></gmp-place-address>
</gmp-place-content-config>

<gmp-place-address></gmp-place-address>
const {PlaceAddressElement} = await google.maps.importLibrary("places");
PlaceAddressElement
PlaceAddressElement([options])
المَعلمات:
السمات المكتسَبة: addEventListener، removeEventListener

PlaceAddressElementOptions interface

interface google.maps.places.PlaceAddressElementOptions
implemented by PlaceAddressElement

خيارات "PlaceAddressElement"

فئة PlaceRatingElement

class google.maps.places.PlaceRatingElement extends HTMLElement implements PlaceRatingElementOptions
library "places"

تضبط هذه السمة PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement لعرض تقييم مكان معيّن. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-rating></gmp-place-rating>
</gmp-place-content-config>

<gmp-place-rating></gmp-place-rating>
const {PlaceRatingElement} = await google.maps.importLibrary("places");
PlaceRatingElement
PlaceRatingElement([options])
المَعلمات:
السمات المكتسَبة: addEventListener، removeEventListener

PlaceRatingElementOptions interface

interface google.maps.places.PlaceRatingElementOptions
implemented by PlaceRatingElement

خيارات "PlaceRatingElement"

فئة PlaceTypeElement

class google.maps.places.PlaceTypeElement extends HTMLElement implements PlaceTypeElementOptions
library "places"

لضبط PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement لعرض نوع المكان يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-type></gmp-place-type>
</gmp-place-content-config>

<gmp-place-type></gmp-place-type>
const {PlaceTypeElement} = await google.maps.importLibrary("places");
PlaceTypeElement
PlaceTypeElement([options])
المَعلمات:
السمات المكتسَبة: addEventListener، removeEventListener

PlaceTypeElementOptions interface

interface google.maps.places.PlaceTypeElementOptions
implemented by PlaceTypeElement

خيارات "PlaceTypeElement"

فئة PlacePriceElement

class google.maps.places.PlacePriceElement extends HTMLElement implements PlacePriceElementOptions
library "places"

تتيح هذه السمة ضبط PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement لعرض مستوى السعر أو نطاق السعر في مكان معيّن. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-price></gmp-place-price>
</gmp-place-content-config>

<gmp-place-price></gmp-place-price>
const {PlacePriceElement} = await google.maps.importLibrary("places");
PlacePriceElement
PlacePriceElement([options])
المَعلمات:
السمات المكتسَبة: addEventListener، removeEventListener

PlacePriceElementOptions interface

interface google.maps.places.PlacePriceElementOptions
implemented by PlacePriceElement

خيارات "PlacePriceElement"

PlaceAccessibleEntranceIconElement class

class google.maps.places.PlaceAccessibleEntranceIconElement extends HTMLElement implements PlaceAccessibleEntranceIconElementOptions
library "places"

يضبط PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement لعرض رمز كرسي متحرّك إذا كان المكان يحتوي على مدخل مناسب للكراسي المتحرّكة. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>
</gmp-place-content-config>

<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>
const {PlaceAccessibleEntranceIconElement} = await google.maps.importLibrary("places");
PlaceAccessibleEntranceIconElement
PlaceAccessibleEntranceIconElement([options])
المَعلمات:
السمات المكتسَبة: addEventListener، removeEventListener

واجهة PlaceAccessibleEntranceIconElementOptions

interface google.maps.places.PlaceAccessibleEntranceIconElementOptions
implemented by PlaceAccessibleEntranceIconElement

خيارات "PlaceAccessibleEntranceIconElement"

فئة PlaceOpenNowStatusElement

class google.maps.places.PlaceOpenNowStatusElement extends HTMLElement implements PlaceOpenNowStatusElementOptions
library "places"

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

 <gmp-place-content-config>
  <gmp-place-open-now-status></gmp-place-open-now-status>
</gmp-place-content-config>

<gmp-place-open-now-status></gmp-place-open-now-status>
const {PlaceOpenNowStatusElement} = await google.maps.importLibrary("places");
PlaceOpenNowStatusElement
PlaceOpenNowStatusElement([options])
المَعلمات:
السمات المكتسَبة: addEventListener، removeEventListener

واجهة PlaceOpenNowStatusElementOptions

interface google.maps.places.PlaceOpenNowStatusElementOptions
implemented by PlaceOpenNowStatusElement

خيارات "PlaceOpenNowStatusElement"

فئة PlaceReviewSummaryElement

class google.maps.places.PlaceReviewSummaryElement extends HTMLElement implements PlaceReviewSummaryElementOptions
library "places"

يضبط PlaceDetailsElement لعرض ملخّص مراجعات مكان معيّن. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-review-summary></gmp-place-review-summary>
</gmp-place-content-config>

<gmp-place-review-summary></gmp-place-review-summary>
const {PlaceReviewSummaryElement} = await google.maps.importLibrary("places");
السمات المكتسَبة: addEventListener، removeEventListener

PlaceReviewSummaryElementOptions interface

interface google.maps.places.PlaceReviewSummaryElementOptions
implemented by PlaceReviewSummaryElement

خيارات "PlaceReviewSummaryElement"

فئة PlaceReviewsElement

class google.maps.places.PlaceReviewsElement extends HTMLElement implements PlaceReviewsElementOptions
library "places"

يتم ضبط PlaceDetailsElement لعرض مراجعات مكان معيّن. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-reviews></gmp-place-reviews>
</gmp-place-content-config>

<gmp-place-reviews></gmp-place-reviews>
const {PlaceReviewsElement} = await google.maps.importLibrary("places");
السمات المكتسَبة: addEventListener، removeEventListener

PlaceReviewsElementOptions interface

interface google.maps.places.PlaceReviewsElementOptions
implemented by PlaceReviewsElement

خيارات "PlaceReviewsElement"

فئة PlaceSummaryElement

class google.maps.places.PlaceSummaryElement extends HTMLElement implements PlaceSummaryElementOptions
library "places"

يضبط هذا الإعداد PlaceDetailsElement لعرض ملخّص عن مكان معيّن. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-summary></gmp-place-summary>
</gmp-place-content-config>

<gmp-place-summary></gmp-place-summary>
const {PlaceSummaryElement} = await google.maps.importLibrary("places");
السمات المكتسَبة: addEventListener، removeEventListener

واجهة PlaceSummaryElementOptions

interface google.maps.places.PlaceSummaryElementOptions
implemented by PlaceSummaryElement

خيارات "PlaceSummaryElement"

PlaceFeatureListElement class

class google.maps.places.PlaceFeatureListElement extends HTMLElement implements PlaceFeatureListElementOptions
library "places"

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

 <gmp-place-content-config>
  <gmp-place-feature-list></gmp-place-feature-list>
</gmp-place-content-config>

<gmp-place-feature-list></gmp-place-feature-list>
const {PlaceFeatureListElement} = await google.maps.importLibrary("places");
السمات المكتسَبة: addEventListener، removeEventListener

واجهة PlaceFeatureListElementOptions

interface google.maps.places.PlaceFeatureListElementOptions
implemented by PlaceFeatureListElement

خيارات "PlaceFeatureListElement"

فئة PlaceOpeningHoursElement

class google.maps.places.PlaceOpeningHoursElement extends HTMLElement implements PlaceOpeningHoursElementOptions
library "places"

يتم ضبط PlaceDetailsElement لعرض ساعات عمل المكان. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-opening-hours></gmp-place-opening-hours>
</gmp-place-content-config>

<gmp-place-opening-hours></gmp-place-opening-hours>
const {PlaceOpeningHoursElement} = await google.maps.importLibrary("places");
السمات المكتسَبة: addEventListener، removeEventListener

PlaceOpeningHoursElementOptions interface

interface google.maps.places.PlaceOpeningHoursElementOptions
implemented by PlaceOpeningHoursElement

خيارات "PlaceOpeningHoursElement"

فئة PlacePhoneNumberElement

class google.maps.places.PlacePhoneNumberElement extends HTMLElement implements PlacePhoneNumberElementOptions
library "places"

يتم ضبط PlaceDetailsElement لعرض رقم هاتف مكان معيّن. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-phone-number></gmp-place-phone-number>
</gmp-place-content-config>

<gmp-place-phone-number></gmp-place-phone-number>
const {PlacePhoneNumberElement} = await google.maps.importLibrary("places");
السمات المكتسَبة: addEventListener، removeEventListener

واجهة PlacePhoneNumberElementOptions

interface google.maps.places.PlacePhoneNumberElementOptions
implemented by PlacePhoneNumberElement

خيارات "PlacePhoneNumberElement"

فئة PlacePlusCodeElement

class google.maps.places.PlacePlusCodeElement extends HTMLElement implements PlacePlusCodeElementOptions
library "places"

يضبط PlaceDetailsElement لعرض رمز Plus Code لمكان معيّن. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-plus-code></gmp-place-plus-code>
</gmp-place-content-config>

<gmp-place-plus-code></gmp-place-plus-code>
const {PlacePlusCodeElement} = await google.maps.importLibrary("places");
السمات المكتسَبة: addEventListener، removeEventListener

واجهة PlacePlusCodeElementOptions

interface google.maps.places.PlacePlusCodeElementOptions
implemented by PlacePlusCodeElement

خيارات "PlacePlusCodeElement"

فئة PlaceTypeSpecificHighlightsElement

class google.maps.places.PlaceTypeSpecificHighlightsElement extends HTMLElement implements PlaceTypeSpecificHighlightsElementOptions
library "places"

تضبط هذه المَعلمة PlaceDetailsElement لعرض أبرز الميزات الخاصة بنوع المكان، مثل أسعار الوقود ومدى توفّر شواحن المركبات الكهربائية. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-type-specific-highlights></gmp-place-type-specific-highlights>
</gmp-place-content-config>

<gmp-place-type-specific-highlights></gmp-place-type-specific-highlights>
const {PlaceTypeSpecificHighlightsElement} = await google.maps.importLibrary("places");
السمات المكتسَبة: addEventListener، removeEventListener

PlaceTypeSpecificHighlightsElementOptions interface

interface google.maps.places.PlaceTypeSpecificHighlightsElementOptions
implemented by PlaceTypeSpecificHighlightsElement

خيارات "PlaceTypeSpecificHighlightsElement"

فئة PlaceWebsiteElement

class google.maps.places.PlaceWebsiteElement extends HTMLElement implements PlaceWebsiteElementOptions
library "places"

لضبط PlaceDetailsElement لعرض الموقع الإلكتروني الخاص بمكان معيّن يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-website></gmp-place-website>
</gmp-place-content-config>

<gmp-place-website></gmp-place-website>
const {PlaceWebsiteElement} = await google.maps.importLibrary("places");
السمات المكتسَبة: addEventListener، removeEventListener

PlaceWebsiteElementOptions interface

interface google.maps.places.PlaceWebsiteElementOptions
implemented by PlaceWebsiteElement

خيارات "PlaceWebsiteElement"

PlaceAttributionElement class

class google.maps.places.PlaceAttributionElement extends HTMLElement implements PlaceAttributionElementOptions
library "places"

يسمح هذا الإعداد بتخصيص نص تحديد المصدر في "خرائط Google" في PlaceDetailsCompactElement أو PlaceDetailsElement أو PlaceSearchElement. يجب إلحاق هذا العنصر كعنصر ثانوي في PlaceContentConfigElement لاستخدامه. في حال حذف هذا العنصر، سيستمر عرض معلومات تحديد المصدر بالألوان التلقائية. على سبيل المثال:

 <gmp-place-content-config>
  <gmp-place-attribution
     light-scheme-color="black"
     dark-scheme-color="white"
  ></gmp-place-attribution>
</gmp-place-content-config>

<gmp-place-attribution
  dark-scheme-color="value-name"
  light-scheme-color="value-name">
</gmp-place-attribution>
const {PlaceAttributionElement} = await google.maps.importLibrary("places");
PlaceAttributionElement
PlaceAttributionElement([options])
المَعلمات:
darkSchemeColor
attr: dark-scheme-color
نوع الإدخال: AttributionColor optional
نوع الإخراج: AttributionColor
القيمة التلقائية: AttributionColor.WHITE
لون مصدر "خرائط Google" في الوضع الداكن
سمة HTML: dark-scheme-color="value-name"
lightSchemeColor
attr: light-scheme-color
نوع الإدخال: AttributionColor optional
نوع الإخراج: AttributionColor
القيمة التلقائية: AttributionColor.GRAY
لون مصدر "خرائط Google" في الوضع الفاتح
سمة HTML: light-scheme-color="value-name"
السمات المكتسَبة: addEventListener، removeEventListener

PlaceAttributionElementOptions

interface google.maps.places.PlaceAttributionElementOptions
implemented by PlaceAttributionElement

خيارات "PlaceAttributionElement"

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

AttributionColor

ثوابت google.maps.places.AttributionColor
مكتبة "places"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع AttributionColorString.

const {AttributionColor} = await google.maps.importLibrary("places");
BLACK نص تحديد المصدر باللون الأسود
GRAY نص تحديد المصدر باللون الرمادي
WHITE نص تحديد المصدر باللون الأبيض

فئة PlaceButtonElement

class google.maps.places.PlaceButtonElement extends HTMLElement implements PlaceButtonElementOptions
library "places"

يعرض هذا المكوّن زرًا في الخانة action-main أو الخانة action-corner. لا يتضمّن "PlaceButtonElement" إعدادًا تلقائيًا. أضِف متتبِّع أحداث إلى العنصر لتحديد سلوكه. سيظهر الزر تلقائيًا في الخانة action-main.

<gmp-place-button
  action-aria-label="string"
  label="string">
</gmp-place-button>
const {PlaceButtonElement} = await google.maps.importLibrary("places");
actionAriaLabel
attr: action-aria-label
النوع: string optional
القيمة التلقائية: undefined
تصنيف ARIA لعنصر التحكّم الداخلي يجب أن تحتوي عناصر التحكّم التي تتضمّن رموزًا فقط على aria-label دائمًا لوصف الغرض منها وسلوكها. لا تعرض عناصر التحكّم المعروضة في الزاوية تصنيفًا، لذا يُنصح باستخدام aria-label بدلاً من التصنيف لعناصر التحكّم في الزاوية.
سمة HTML: action-aria-label="string"
label
attr: label
النوع: string optional
القيمة التلقائية: undefined
التصنيف الذي سيتم عرضه في عنصر التحكّم. بالنسبة إلى الروابط التي تتضمّن أنواع إجراءات محدّدة مسبقًا، يتم تجاهل هذه السمة. لا تعرض الروابط والأزرار المعروضة في خانة ركن الإجراء تصنيفًا. ننصحك باستخدام السمة action-aria-label بدلاً من ذلك لعناصر التحكّم في الزوايا.
سمة HTML: label="string"
icon-start
خانة لمحتوى الرمز تبدأ قبل التصنيف يُستخدَم هذا الخيار لعناصر التحكّم في الإجراءات الرئيسية والجانبية. عندما يتم تصغير عنصر تحكّم إلى حالته في الزاوية، يتم عرض المحتوى في هذه الخانة.
button
جزء من CSS يستهدف عنصر التحكّم الداخلي
السمات المكتسَبة: addEventListener، removeEventListener
gmp-click
function(event)
الوسيطات:
يتم تنشيطه عند النقر على عنصر التحكّم.

PlaceButtonElementOptions interface

interface google.maps.places.PlaceButtonElementOptions
implemented by PlaceButtonElement

خيارات "PlaceButtonElement"

actionAriaLabel
اختياري
النوع: string optional
تصنيف ARIA لعنصر التحكّم الداخلي يجب أن تحتوي عناصر التحكّم التي تتضمّن رموزًا فقط على aria-label دائمًا لوصف الغرض منها وسلوكها. لا تعرض عناصر التحكّم المعروضة في الزاوية تصنيفًا، لذا يُنصح باستخدام aria-label بدلاً من التصنيف لعناصر التحكّم في الزاوية.
label
اختياري
النوع: string optional
التصنيف الذي سيتم عرضه في عنصر التحكّم. بالنسبة إلى الروابط التي تتضمّن أنواع إجراءات محدّدة مسبقًا، يتم تجاهل هذه السمة. لا تعرض الروابط والأزرار المعروضة في خانة ركن الإجراء تصنيفًا. ننصحك باستخدام السمة action-aria-label بدلاً من ذلك لعناصر التحكّم في الزوايا.

فئة PlaceLinkElement

class google.maps.places.PlaceLinkElement extends HTMLElement implements PlaceLinkElementOptions
library "places"

تعرض هذه السمة رابطًا تم إدراجه في الخانة action-main أو الخانة action-corner. سيظهر الرابط تلقائيًا في الخانة action-main. استخدِم السمة action لتحديد سلوك الرابط. تتوفّر عدة أنواع من الإجراءات التي يمكن استخدامها، وهي مُدرَجة في ActionLinkType. بالنسبة إلى الرابط المخصّص، حدِّد نوع الإجراء custom واضبط السمتَين href وlabel.

<gmp-place-link
  action="value-name"
  action-aria-label="string"
  href="string"
  label="string"
  target="string">
</gmp-place-link>
const {PlaceLinkElement} = await google.maps.importLibrary("places");
action
attr: action
النوع: ActionLinkType optional
نوع الإجراء المطلوب تنفيذه عند النقر على الرابط يحدّد هذا الحقل التصنيف والرمز التلقائيَين وسمة href للوجهة في الرابط. استخدِم النوع custom وحدِّد السمة href لضبط وجهة يدويًا.
سمة HTML: action="value-name"
actionAriaLabel
attr: action-aria-label
النوع: string optional
القيمة التلقائية: undefined
تصنيف ARIA لعنصر التحكّم الداخلي يجب أن تحتوي عناصر التحكّم التي تتضمّن رموزًا فقط على aria-label دائمًا لوصف الغرض منها وسلوكها. لا تعرض عناصر التحكّم المعروضة في الزاوية تصنيفًا، لذا يُنصح باستخدام aria-label بدلاً من التصنيف لعناصر التحكّم في الزاوية.
سمة HTML: action-aria-label="string"
href
attr: href
النوع: string optional
القيمة التلقائية: undefined
عنوان URL الذي يتم فتحه عند النقر على الرابط لا يتم استخدام هذه السمة إلا عند ضبط السمة action على custom.
سمة HTML: href="string"
label
attr: label
النوع: string optional
القيمة التلقائية: undefined
التصنيف الذي سيتم عرضه في عنصر التحكّم. بالنسبة إلى الروابط التي تتضمّن أنواع إجراءات محدّدة مسبقًا، يتم تجاهل هذه السمة. لا تعرض الروابط والأزرار المعروضة في خانة ركن الإجراء تصنيفًا. ننصحك باستخدام السمة action-aria-label بدلاً من ذلك لعناصر التحكّم في الزوايا.
سمة HTML: label="string"
target
attr: target
النوع: string optional
القيمة التلقائية: undefined
تحدّد هذه السمة مكان فتح الرابط. يُرجى الاطّلاع على https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#target.
سمة HTML: target="string"
icon-start
خانة لمحتوى الرمز تبدأ قبل التصنيف يُستخدَم هذا الخيار لعناصر التحكّم في الإجراءات الرئيسية والجانبية. عندما يتم تصغير عنصر تحكّم إلى حالته في الزاوية، يتم عرض المحتوى في هذه الخانة.
button
جزء من CSS يستهدف عنصر التحكّم الداخلي
السمات المكتسَبة: addEventListener، removeEventListener
gmp-click
function(event)
الوسيطات:
يتم تنشيطه عند النقر على عنصر التحكّم.

PlaceLinkElementOptions interface

interface google.maps.places.PlaceLinkElementOptions
implemented by PlaceLinkElement

خيارات "PlaceLinkElement"

action
اختياري
النوع: ActionLinkType optional
يمكنك الاطّلاع على PlaceLinkElement.action.
actionAriaLabel
اختياري
النوع: string optional
تصنيف ARIA لعنصر التحكّم الداخلي يجب أن تحتوي عناصر التحكّم التي تتضمّن رموزًا فقط على aria-label دائمًا لوصف الغرض منها وسلوكها. لا تعرض عناصر التحكّم المعروضة في الزاوية تصنيفًا، لذا يُنصح باستخدام aria-label بدلاً من التصنيف لعناصر التحكّم في الزاوية.
href
اختياري
النوع: string optional
يمكنك الاطّلاع على PlaceLinkElement.href.
label
اختياري
النوع: string optional
التصنيف الذي سيتم عرضه في عنصر التحكّم. بالنسبة إلى الروابط التي تتضمّن أنواع إجراءات محدّدة مسبقًا، يتم تجاهل هذه السمة. لا تعرض الروابط والأزرار المعروضة في خانة ركن الإجراء تصنيفًا. ننصحك باستخدام السمة action-aria-label بدلاً من ذلك لعناصر التحكّم في الزوايا.
target
اختياري
النوع: string optional
يمكنك الاطّلاع على PlaceLinkElement.target.

ثوابت ActionLinkType

ثوابت google.maps.places.ActionLinkType
مكتبة "places"

الإجراء الذي يتّخذه PlaceLinkElement عند النقر عليه يحدّد الرمز والتصنيف ووجهة href.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع ActionLinkTypeString.

const {ActionLinkType} = await google.maps.importLibrary("places");
CALL يؤدي إلى تشغيل رابط tel: للاتصال بالمكان. يعتمد السلوك على نظام التشغيل.
CUSTOM استخدِم نوع الإجراء هذا للروابط المخصّصة. عند استخدام نوع الإجراء هذا، يجب ضبط السمة href على PlaceLinkElement.
OPEN_DIRECTIONS يفتح هذا الإجراء الاتجاهات إلى المكان في الموقع الجغرافي المحدّد في PlaceLinkElement.target.
OPEN_MAP يفتح الخريطة في الموقع الجغرافي المحدّد من خلال PlaceLinkElement.target.
OPEN_WEBSITE يفتح الموقع الإلكتروني للمكان في الموقع الجغرافي المحدّد في PlaceLinkElement.target.

ثوابت ActionButtonPosition

ثوابت google.maps.places.ActionButtonPosition
مكتبة "places"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع ActionButtonPositionString.

const {ActionButtonPosition} = await google.maps.importLibrary("places");
ACTION_CORNER يتم عرض عنصر التحكّم في زاوية التطبيق المصغّر. تعرض عناصر التحكّم في الزاوية رمزًا فقط.
ACTION_MAIN يتم عرض عنصر التحكّم في منطقة المحتوى الرئيسية في التطبيق المصغّر. يتم عرض التصنيفات والرموز.

فئة PlaceActionEvent

class google.maps.places.PlaceActionEvent extends Event
library "places"

الحدث الذي يتم تنفيذه عند النقر على زر الإجراء

const {PlaceActionEvent} = await google.maps.importLibrary("places");
place
readonly
النوع: Place
المكان الذي تم النقر عليه

فئة PlaceNameElement

class google.maps.places.PlaceNameElement extends HTMLElement implements PlaceNameElementOptions
library "places"

تعرض هذه السمة اسم مكان ضمن عنصر تفاصيل المكان.

<gmp-place-name></gmp-place-name>
const {PlaceNameElement} = await google.maps.importLibrary("places");
السمات المكتسَبة: addEventListener، removeEventListener

PlaceNameElementOptions interface

interface google.maps.places.PlaceNameElementOptions
implemented by PlaceNameElement

خيارات "PlaceNameElement"