Place (beta)

مكان المكان

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

يمكنك الوصول من خلال الاتصال بـ const {Place} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

Place
Place(options)
المعلّمات: 
BetafindPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
المعلّمات: 
قيمة العرض:  Promise<{places:Array<Place>}>
يبحث عن مكان استنادًا إلى رقم الهاتف المحدد. عرض صفيف بسبب حالات نادرة قد يشارك فيها عدة أماكن رقم هاتف
BetafindPlaceFromQuery
findPlaceFromQuery(request)
المعلّمات: 
  • requestFindPlaceFromQueryRequest الطلب الذي يتضمّن طلب البحث النصي والحقول المطلوبة
قيمة العرض:  Promise<{places:Array<Place>}>
يبحث عن مكان استنادًا إلى طلب البحث النصي المحدد. تعرض صفيفًا بسبب الحالات التي يكون فيها طلب البحث غامضًا قليلاً، ويتم عرض أكثر من مكان واحد. ولا تهدف هذه الطريقة إلى إجراء عمليات البحث التي يُتوقّع أن تكون فيها نتائج متعددة.
addressComponents
النوع:  Array<AddressComponent> optional
مجموعة مكوّنات العنوان الخاصة بالموقع الجغرافي لهذا المكان عنصر فارغ إذا لم تكن هناك بيانات عنوان معروفة. undefined إذا لم يتم طلب بيانات العنوان من الخادم.
adrFormatAddress
النوع:  string optional
تمثيل عنوان المكان في تنسيق نمط ملف adr.
attributions
النوع:  Array<Attribution> optional
نص الإحالة الذي سيتم عرضه لنتيجة المكان هذه.
businessStatus
النوع:  BusinessStatus optional
الحالة التشغيلية للموقع الجغرافي. null إذا لم تكن هناك حالة معروفة. undefined إذا لم يتم تحميل بيانات الحالة من الخادم.
displayName
النوع:  string optional
الاسم المعروض للموقع الجغرافي. null إذا لم يكن هناك اسم. undefined إذا لم يتم تحميل بيانات الاسم من الخادم.
formattedAddress
النوع:  string optional
عنوان الموقع الجغرافي بالكامل
googleMapsURI
النوع:  string optional
عنوان URL لصفحة Google الرسمية لهذا المكان. هذه هي الصفحة التي تملكها Google وتحتوي على أفضل المعلومات المتاحة عن المكان.
hasCurbsidePickup
النوع:  boolean optional
ما إذا كان المكان تتوفّر فيه خدمة الإيصال إلى السيارة. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasDelivery
النوع:  boolean optional
ما إذا كان المكان تتوفّر فيه خدمة التوصيل تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasDineIn
النوع:  boolean optional
إمكانية تناول الطعام في المكان تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasTakeout
النوع:  boolean optional
ما إذا كان المكان يحتوي على طعام سفري أم لا. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasWheelchairAccessibleEntrance
النوع:  boolean optional
ما إذا كان المكان يحتوي على مدخل صالح للكراسي المتحركة تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
iconBackgroundColor
النوع:  string optional
رمز لون HEX التلقائي لفئة المكان.
id
النوع:  string
معرّف المكان الفريد.
internationalPhoneNumber
النوع:  string optional
تمثّل هذه السمة رقم هاتف المكان بالتنسيق الدولي. ويحتوي التنسيق الدولي على رمز البلد، مسبوقًا بعلامة الجمع (+).
isReservable
النوع:  boolean optional
ما إذا كان المكان قابلاً للحجز. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
location
النوع:  LatLng optional
تمثّل هذه السمة موضع المكان.
nationalPhoneNumber
النوع:  string optional
رقم هاتف المكان، منسَّق وفقًا للمؤتمر الإقليمي للرقم
openingHours
النوع:  OpeningHours optional
photos
النوع:  Array<Photo> optional
صور لهذا المكان. ستتضمّن المجموعة ما يصل إلى عشرة عناصر Photo.
plusCode
النوع:  PlusCode optional
priceLevel
النوع:  PriceLevel optional
مستوى سعر المكان. يمكن أن يعرض هذا الموقع أيًّا من القيم التالية
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
النوع:  number optional
تقييم يتراوح من 1.0 إلى 5.0، استنادًا إلى مراجعات المستخدمين لهذا المكان.
requestedLanguage
النوع:  string optional
اللغة المطلوبة لهذا المكان
requestedRegion
النوع:  string optional
تمثّل هذه السمة المنطقة المطلوبة لهذا المكان.
reviews
النوع:  Array<Review> optional
قائمة بمراجعات لهذا المكان.
servesBeer
النوع:  boolean optional
مكان يقدّم البيرة تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesBreakfast
النوع:  boolean optional
ما إذا كان المكان يقدّم وجبات الفطور. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesBrunch
النوع:  boolean optional
ما إذا كان المكان يقدّم وجبات الإفطار المتأخر أم لا. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesDinner
النوع:  boolean optional
ما إذا كان المكان يقدّم العشاء أم لا. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesLunch
النوع:  boolean optional
ما إذا كان المكان يقدّم وجبات الغداء. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesVegetarianFood
النوع:  boolean optional
ما إذا كان أحد الأماكن يقدّم مأكولات نباتية تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesWine
النوع:  boolean optional
ما إذا كان المكان يقدّم النبيذ. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
svgIconMaskURI
النوع:  string optional
معرّف الموارد المنتظم (URI) إلى مورد قناع الصورة بتنسيق svg الذي يمكن استخدامه لتمثيل فئة مكان.
types
النوع:  Array<string> optional
مصفوفة من أنواع هذا المكان (على سبيل المثال، ["political", "locality"] أو ["restaurant", "establishment"]).
userRatingCount
النوع:  number optional
عدد تقييمات المستخدمين التي ساهمت في Place.rating لهذا المكان.
utcOffsetMinutes
النوع:  number optional
التوقيت بالدقائق حسب التوقيت العالمي المنسَّق (UTC) للمنطقة الزمنية الحالية للمكان على سبيل المثال، توقيت شرق النمسا الرسمي (GMT+10) في التوقيت الصيفي متقدم بنسبة 11 ساعة بالتوقيت العالمي المتفق عليه، وبالتالي سيكون utc_offset_minutes 660. بالنسبة إلى المناطق الزمنية خلف التوقيت العالمي المنسق، تكون التعويض سالبة. على سبيل المثال، utc_offset_minutes هو -60 لرأس المال الأخضر.
viewport
النوع:  LatLngBounds optional
إطار العرض المفضّل عند عرض هذا المكان على الخريطة
websiteURI
النوع:  string optional
الموقع الإلكتروني الموثوق به لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري.
BetafetchFields
fetchFields(options)
المعلّمات: 
قيمة العرض:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
المعلّمات: 
  • dateDate optional
قيمة العرض:  Promise<Date optional>
تحسب التاريخ الذي يمثّل ساعات العمل التالية. عرض غير معروف إذا كانت البيانات غير كافية لحساب النتيجة، أو هذا المكان لا يعمل.
BetaisOpen
isOpen([date])
المعلّمات: 
  • dateDate optional الإعدادات التلقائية الآن.
قيمة العرض:  Promise<boolean optional>
تحقّق مما إذا كان المكان مفتوحًا في تاريخ ووقت محدّد. يتم التعامل مع undefined إذا كانت البيانات المعروفة للموقع الجغرافي غير كافية لحساب ذلك، مثلاً إذا كانت ساعات العمل غير مسجَّلة.
toJSON
toJSON()
المعلّمات: بدون
قيمة العرض:  Object لكائن JSON يتضمّن جميع خصائص المكان المطلوبة.

واجهة PlaceOptions

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

خيارات لبناء مكان.

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

فئةAddressPlugins

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

يمكنك الوصول من خلال الاتصال بـ const {AddressComponent} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

longText
النوع:  string optional
النص الكامل لمكوِّن العنوان.
shortText
النوع:  string optional
النص القصير والقصير للمكوّن في العنوان المحدد.
types
النوع:  Array<string>
مصفوفة من السلاسل تشير إلى نوع مكوّن العنوان هذا. يمكنك الاطّلاع على قائمة بالأنواع الصالحة هنا.

فئةالإحالة

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

يمكنك الوصول من خلال الاتصال بـ const {Attribution} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

provider
النوع:  string optional
نص الإحالة الذي سيتم عرضه لنتيجة المكان هذه.
providerURI
النوع:  string optional

واجهة FetchFieldsRequest

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

خيارات جلب حقول المكان

fields
النوع:  Array<string>
قائمة الحقول التي سيتم جلبها
sessionToken optional
النوع:  AutocompleteSessionToken optional
مرجع فريد يُستخدَم لتجميع طلب التفاصيل مع جلسة إكمال تلقائي.

ساعات العمل

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

يمكنك الوصول من خلال الاتصال بـ const {OpeningHours} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

periods
النوع:  Array<OpeningHoursPeriod>
فترات الافتتاح التي تغطي كل يوم من الأسبوع، بدءًا من الأحد، بترتيب زمني. ولا يتضمن الأيام التي لا يتم فيها فتح هذا المكان.
weekdayDescriptions
النوع:  Array<string>
مصفوفة من سبعة سلاسل تمثّل ساعات العمل المنسّقة لكل يوم من أيام الأسبوع. ستعمل خدمة "الأماكن" على تنسيق ساعات العمل وأقلمةها بشكلٍ مناسب للغة الحالية. ويعتمد ترتيب العناصر في هذه المصفوفة على اللغة. وبعض اللغات تبدأ الأسبوع يوم الاثنين، بينما تبدأ اللغات الأخرى يوم الأحد.

فئة OpeningHoursPeriod

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

يمكنك الوصول من خلال الاتصال بـ const {OpeningHoursPeriod} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

close
النوع:  OpeningHoursPoint optional
وقت الإغلاق للمكان.
open
النوع:  OpeningHoursPoint
حان وقت المكان.

فئة OpeningHoursPoint

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

يمكنك الوصول من خلال الاتصال بـ const {OpeningHoursPoint} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

day
النوع:  number
اليوم من الأسبوع، كرقم في النطاق [0، 6]، بدءًا من الأحد. على سبيل المثال، 2 يُقصد بهما الثلاثاء.
hour
النوع:  number
ساعة OpeningHoursPoint.time كرقم في النطاق [0, 23]. سيتم الإبلاغ عن ذلك في المنطقة الزمنية للمكان.
minute
النوع:  number
الدقيقة الخاصة بـ OpeningHoursPoint.time كرقم في النطاق [0, 59]. سيتم الإبلاغ عن ذلك في المنطقة الزمنية للمكان.

صورة الفئة

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

يمكنك الوصول من خلال الاتصال بـ const {Photo} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

attributions
النوع:  Array<PhotoAttribution>
نص الإحالة الذي سيتم عرضه لهذه الصورة.
heightPx
النوع:  number
ارتفاع الصورة بالبكسل.
widthPx
النوع:  number
عرض الصورة بالبكسل.
getURI
getURI([options])
المعلّمات: 
قيمة العرض:  string
تعرض عنوان URL للصورة المقابل للخيارات المحدّدة.

فئة ضمن الإحالة

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

يمكنك الوصول من خلال الاتصال بـ const {PhotoAttribution} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

author
النوع:  string
نص الإحالة الذي سيتم عرضه لنتيجة الصور هذه.
authorURI
النوع:  string optional

فئة PlusCode

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

يمكنك الوصول من خلال الاتصال بـ const {PlusCode} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

compoundCode
النوع:  string optional
رمز علامة جمع يتضمّن درجة 1/8000 من الدرجة بمقدار 1/8000 من منطقة الدرجة حيث يتم إسقاط الأحرف الأربعة الأولى (رمز المنطقة) واستبدالها بوصف محلي. على سبيل المثال، "9G8F+5W زيورخ، سويسرا".
globalCode
النوع:  string optional
رمز علامة جمع يتضمّن درجة 1/8000 درجة من الدرجة 1/8000 على سبيل المثال، "8FVC9G8F+5W".

مراجعة الفئة

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

يمكنك الوصول من خلال الاتصال بـ const {Review} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

author
النوع:  string optional
تمثّل هذه السمة اسم المُراجع.
authorPhotoURI
النوع:  string optional
عنوان URL يؤدي إلى صورة الملف الشخصي لصاحب التسجيل
authorURI
النوع:  string optional
عنوان URL ينقل إلى الملف الشخصي للمُراجع
publishTime
النوع:  Date optional
rating
النوع:  number optional
تمثّل هذه السمة تقييم هذه المراجعة، تتراوح قيمتها بين 1.0 و5.0 (شاملة).
relativePublishTimeDescription
النوع:  string optional
سلسلة من الوقت الأخير المنسّق تعبّر عن وقت المراجعة بالنسبة إلى الوقت الحالي باستخدام نموذج مناسب للغة والبلد. على سبيل المثال، ""قبل شهر".
text
النوع:  string optional
تمثّل هذه السمة نص المراجعة.
textLanguageCode
النوع:  string optional
رمز لغة مجموعة مهندسي شبكة الإنترنت (IETF) يشير إلى اللغة التي تمت كتابة هذه المراجعة بها. تجدر الإشارة إلى أنّ هذا الرمز يشمل فقط علامة اللغة الرئيسية بدون أي علامة ثانوية تشير إلى البلد أو المنطقة. على سبيل المثال، يتم وضع علامة 'en' على جميع المراجعات باللغة الإنجليزية بدلاً من "en-AU" أو "en-UK".

ثوابت PriceLevel

google.maps.places.PriceLevel ثوابت

تعداد مستوى السعر لعناصر المكان.

يمكنك الوصول من خلال الاتصال بـ const {PriceLevel} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE