Place

فئة المكان

google.maps.places.Place صف

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Place} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
Place
Place(options)
المَعلمات: 
searchByText
searchByText(request)
المَعلمات: 
قيمة العائد:  Promise<{places:Array<Place>}>
البحث عن أماكن استنادًا إلى طلب بحث نصي
searchNearby
searchNearby(request)
المَعلمات: 
قيمة العائد:  Promise<{places:Array<Place>}>
البحث عن أماكن قريبة
accessibilityOptions
النوع:  AccessibilityOptions optional
خيارات تسهيل الاستخدام في هذا المكان ‫undefined إذا لم يتم طلب بيانات خيارات تسهيل الاستخدام من الخادم.
addressComponents
النوع:  Array<AddressComponent> optional
مجموعة مكوّنات العنوان الخاص بالموقع الجغرافي لهذا المكان عنصر فارغ إذا لم تتوفّر بيانات عناوين معروفة. undefined إذا لم يتم طلب بيانات العنوان من الخادم.
adrFormatAddress
النوع:  string optional
تمثيل عنوان "المكان" بتنسيق adr المصغّر
allowsDogs
النوع:  boolean optional
attributions
النوع:  Array<Attribution> optional
نص تحديد المصدر الذي سيتم عرضه لنتيجة المكان هذه.
businessStatus
النوع:  BusinessStatus optional
تمثّل هذه السمة حالة التشغيل للموقع الجغرافي. ‫null إذا لم تكن هناك حالة معروفة. ‫undefined إذا لم يتم تحميل بيانات الحالة من الخادم.
displayName
النوع:  string optional
تمثّل هذه السمة الاسم المعروض للموقع الجغرافي. null إذا لم يكن هناك اسم undefined إذا لم يتم تحميل بيانات الاسم من الخادم.
displayNameLanguageCode
النوع:  string optional
لغة الاسم المعروض للموقع الجغرافي. null إذا لم يكن هناك اسم undefined إذا لم يتم تحميل بيانات الاسم من الخادم.
editorialSummary
النوع:  string optional
الملخّص التحريري لهذا المكان ‫null إذا لم يكن هناك ملخّص تحريري ‫undefined إذا لم يتم طلب هذا الحقل بعد
editorialSummaryLanguageCode
النوع:  string optional
لغة الملخّص التحريري لهذا المكان ‫null إذا لم يكن هناك ملخّص تحريري ‫undefined إذا لم يتم طلب هذا الحقل بعد
evChargeOptions
النوع:  EVChargeOptions optional
خيارات شحن المركبات الكهربائية التي يوفّرها المكان undefined إذا لم يتم طلب خيارات شحن المركبات الكهربائية من الخادم.
formattedAddress
النوع:  string optional
تمثّل هذه السمة العنوان الكامل للموقع الجغرافي.
fuelOptions
النوع:  FuelOptions optional
خيارات الوقود التي يوفّرها المكان undefined إذا لم يتم طلب خيارات الوقود من الخادم.
googleMapsURI
النوع:  string optional
تمثّل هذه السمة عنوان URL لصفحة Google الرسمية الخاصة بهذا المكان. هذه هي الصفحة التي تملكها Google والتي تحتوي على أفضل المعلومات المتاحة حول "المكان".
hasCurbsidePickup
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم خدمة الاستلام من السيارة. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasDelivery
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم خدمة توصيل الطلبات. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasDineIn
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر خدمة تناول الطعام في الداخل. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasLiveMusic
النوع:  boolean optional
hasMenuForChildren
النوع:  boolean optional
hasOutdoorSeating
النوع:  boolean optional
hasRestroom
النوع:  boolean optional
hasTakeout
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر خدمة استلام الطلبات. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
iconBackgroundColor
النوع:  string optional
رمز اللون السداسي العشري التلقائي لفئة المكان
id
النوع:  string
المعرّف الفريد للمكان.
internationalPhoneNumber
النوع:  string optional
رقم هاتف المكان بالتنسيق الدولي يتضمّن التنسيق الدولي رمز البلد، ويسبقه علامة الجمع (+).
isGoodForChildren
النوع:  boolean optional
isGoodForGroups
النوع:  boolean optional
isGoodForWatchingSports
النوع:  boolean optional
isReservable
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يتيح الحجز. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
location
النوع:  LatLng optional
تمثّل هذه السمة موضع المكان.
nationalPhoneNumber
النوع:  string optional
رقم هاتف المكان، منسَّق وفقًا للاتفاقية الإقليمية الخاصة بالرقم
parkingOptions
النوع:  ParkingOptions optional
خيارات مواقف السيارات التي يوفّرها المكان undefined إذا لم يتم طلب بيانات خيارات مواقف السيارات من الخادم.
paymentOptions
النوع:  PaymentOptions optional
خيارات الدفع التي يوفّرها المكان ‫undefined إذا لم يتم طلب بيانات خيارات الدفع من الخادم.
photos
النوع:  Array<Photo> optional
صور لهذا المكان ستحتوي المجموعة على ما يصل إلى عشرة عناصر من النوع Photo.
plusCode
النوع:  PlusCode optional
priceLevel
النوع:  PriceLevel optional
تمثّل هذه السمة مستوى سعر "المكان". يمكن أن تعرض هذه السمة أيًا من القيم التالية
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
primaryType
النوع:  string optional
تمثّل هذه السمة النوع الأساسي للموقع الجغرافي. ‫null إذا لم يكن هناك نوع ‫undefined إذا لم يتم تحميل بيانات النوع من الخادم
primaryTypeDisplayName
النوع:  string optional
تمثّل هذه السمة الاسم المعروض للنوع الأساسي للموقع الجغرافي. ‫null إذا لم يكن هناك نوع ‫undefined إذا لم يتم تحميل بيانات النوع من الخادم
primaryTypeDisplayNameLanguageCode
النوع:  string optional
لغة الاسم المعروض للنوع الأساسي للموقع الجغرافي. ‫null إذا لم يكن هناك نوع ‫undefined إذا لم يتم تحميل بيانات النوع من الخادم
rating
النوع:  number optional
يشير إلى تقييم يتراوح بين 1.0 و5.0 استنادًا إلى مراجعات المستخدمين لهذا المكان.
regularOpeningHours
النوع:  OpeningHours optional
requestedLanguage
النوع:  string optional
تمثّل هذه السمة اللغة المطلوبة لهذا المكان.
requestedRegion
النوع:  string optional
المنطقة المطلوبة لهذا المكان
reviews
النوع:  Array<Review> optional
قائمة بالمراجعات الخاصة بهذا المكان
servesBeer
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم البيرة. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesBreakfast
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم وجبة الفطور. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesBrunch
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم وجبات الإفطار المتأخر. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesCocktails
النوع:  boolean optional
servesCoffee
النوع:  boolean optional
servesDessert
النوع:  boolean optional
servesDinner
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم العشاء. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesLunch
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم وجبة الغداء. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesVegetarianFood
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم طعامًا نباتيًا. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesWine
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم النبيذ. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
svgIconMaskURI
النوع:  string optional
معرّف الموارد المنتظم (URI) الخاص بمورد قناع صورة SVG الذي يمكن استخدامه لتمثيل فئة مكان
types
النوع:  Array<string> optional
تمثّل هذه السمة مصفوفة أنواع لهذا المكان (مثل ["political", "locality"] أو ["restaurant", "establishment"]).
userRatingCount
النوع:  number optional
عدد تقييمات المستخدمين التي ساهمت في حصول هذا المكان على Place.rating.
utcOffsetMinutes
النوع:  number optional
تمثّل هذه السمة الفرق بين المنطقة الزمنية الحالية للمكان والتوقيت العالمي المنسّق، وذلك بالدقائق. على سبيل المثال، يسبق توقيت شرق أستراليا الرسمي (GMT+10) التوقيت العالمي المنسَّق بـ 11 ساعة في التوقيت الصيفي، لذا سيكون utc_offset_minutes هو 660. بالنسبة إلى المناطق الزمنية التي تسبق التوقيت العالمي المتفق عليه، يكون فارق التوقيت سالبًا. على سبيل المثال، utc_offset_minutes هو -60 في الرأس الأخضر.
viewport
النوع:  LatLngBounds optional
إطار العرض المفضّل عند عرض هذا المكان على خريطة
websiteURI
النوع:  string optional
الموقع الإلكتروني الموثوق لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري
openingHours
النوع:  OpeningHours optional
hasWiFi
النوع:  boolean optional
fetchFields
fetchFields(options)
المَعلمات: 
قيمة العائد:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
المَعلمات: 
  • date:  Date optional
قيمة العائد:  Promise<Date optional>
تحسب هذه السمة التاريخ الذي يمثّل قيمة OpeningHoursTime التالية. تعرض هذه السمة القيمة "غير محدّد" إذا كانت البيانات غير كافية لاحتساب النتيجة، أو إذا كان هذا المكان غير صالح للعمل.
BetaisOpen
isOpen([date])
المَعلمات: 
  • date:  Date optional يكون تلقائيًا هو الوقت الحالي.
قيمة العائد:  Promise<boolean optional>
تحقَّق ممّا إذا كان المكان مفتوحًا في التاريخ والوقت المحدّدَين. يتم عرض undefined إذا كانت البيانات المعروفة للموقع الجغرافي غير كافية لاحتساب هذه القيمة، مثلاً إذا كانت ساعات العمل غير مسجّلة.
toJSON
toJSON()
المَعلمات:  بدون
القيمة المعروضة:  Object عنصر JSON يتضمّن جميع خصائص "المكان" المطلوبة.

PlaceOptions interface

google.maps.places.PlaceOptions interface

خيارات لإنشاء "مكان"
id
النوع:  string
المعرّف الفريد للمكان.
requestedLanguage optional
النوع:  string optional
معرّف اللغة التي يجب عرض التفاصيل بها اطّلِع على قائمة اللغات المتاحة.
requestedRegion optional
النوع:  string optional
رمز المنطقة التي يقيم فيها المستخدم ويمكن أن يؤثر ذلك في الصور التي قد يتم عرضها، وربما في أمور أخرى. يقبل رمز المنطقة قيمة ccTLD ("نطاق المستوى الأعلى") مكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز ccTLD الخاص بالمملكة المتحدة هو "uk" (.co.uk)، بينما رمز ISO 3166-1 هو "gb" (وهو يشير من الناحية الفنية إلى "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").

فئة AccessibilityOptions

google.maps.places.AccessibilityOptions صف

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AccessibilityOptions} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
hasWheelchairAccessibleEntrance
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر مدخلاً صالحًا للكراسي المتحركة. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة.
hasWheelchairAccessibleParking
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر موقف سيارات مناسبًا لأصحاب الكراسي المتحرّكة. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة.
hasWheelchairAccessibleRestroom
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر دورة مياه مناسبة لأصحاب الكراسي المتحرّكة. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة.
hasWheelchairAccessibleSeating
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر أماكن جلوس مناسبة لأصحاب الكراسي المتحرّكة. تعرض هذه السمة القيمة "صحيح" أو "خطأ" إذا كانت القيمة معروفة. تعرِض القيمة "null" إذا كانت القيمة غير معروفة.

فئة AddressComponent

google.maps.places.AddressComponent صف

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AddressComponent} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
longText
النوع:  string optional
تمثّل هذه السمة النص الكامل لمكوّن العنوان.
shortText
النوع:  string optional
تمثّل هذه السمة النص المختصر لمكوّن العنوان المحدّد.
types
النوع:  Array<string>
تمثّل هذه السمة مصفوفة من السلاسل التي تشير إلى نوع عنصر العنوان هذا. يمكنك الاطّلاع على قائمة بالأنواع الصالحة