Place (beta)

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مكان

google.maps.places.Place الصف الدراسي

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {Place} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
Place
Place(options)
المعلّمات:
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
المعلّمات:
قيمة الإرجاع: Promise<{places:Array<Place>}>
يبحث عن مكان استنادًا إلى رقم الهاتف. لعرض مصفوفة بسبب حالات نادرة حيث قد تتشارك عدة أماكن رقم هاتف.
findPlaceFromQuery
findPlaceFromQuery(request)
المعلّمات:
  • request: FindPlaceFromQueryRequest الطلب الذي يحتوي على طلب البحث النصي والحقول المطلوبة.
قيمة الإرجاع: Promise<{places:Array<Place>}>
يبحث عن مكان استنادًا إلى طلب بحث نصي معيّن. لعرض مصفوفة بسبب الحالات التي يكون فيها طلب البحث غامضًا بشكل بسيط، ويتم عرض أكثر من مكان واحد. هذه الطريقة غير مخصّصة لعمليات البحث التي يُتوقع أن تظهر فيها نتائج متعددة.
addressComponents
النوع: Array<AddressComponent> optional
مجموعة مكونات العنوان لموقع هذا المكان. كائن فارغ إذا لم تكن هناك بيانات عنوان معروفة. undefined إذا لم يتم طلب بيانات العنوان من الخادم.
adrFormatAddress
النوع: string optional
تمثيل عنوان المكان في adr microformat
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' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasDelivery
النوع: boolean optional
ما إذا كان المكان يوفّر خدمة التوصيل. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasDineIn
النوع: boolean optional
ما إذا كان المكان يتناول الطعام فيه أم لا. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasTakeout
النوع: boolean optional
ما إذا كان المكان يحتوي على طعام سفري. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasWheelchairAccessibleEntrance
النوع: boolean optional
ما إذا كان المكان يحتوي على مدخل صالح للكراسي المتحركة. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
icon
النوع: string optional
عنوان URL لمورد صورة يمكن استخدامه لتمثيل فئة هذا الموقع.
iconBackgroundColor
النوع: string optional
رمز اللون HEX التلقائي لفئة المكان.
id
النوع: string
رقم تعريف المكان الفريد.
internationalPhoneNumber
النوع: string optional
رقم هاتف المكان بالتنسيق الدولي. يتضمن التنسيق الدولي رمز البلد، مسبوقًا بالعلامة (+).
isReservable
النوع: boolean optional
ما إذا كان المكان قابلاً للحجز. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
location
النوع: LatLng optional
تمثل هذه الخاصية موضع المكان.
nationalPhoneNumber
النوع: string optional
رقم هاتف المكان، مُنسَّق وفقًا للاتفاقية الإقليمية للرقم.
openingHours
النوع: OpeningHours optional
photos
النوع: Array<Photo> optional
صور لهذا المكان. ستتضمّن المجموعة ما يصل إلى عشرة كائنات Photo.
plusCode
النوع: PlusCode optional
priceLevel
النوع: number optional
مستوى سعر المكان على مقياس من 0 إلى 4. يتم تفسير مستويات الأسعار على النحو التالي:
  • 0: مجاني
  • 1: غير مكلف
  • 2: معتدل
  • 3: غالٍ
  • 4: غالٍ جدًا
rating
النوع: number optional
تقييم ما بين 1.0 و5.0، استنادًا إلى تعليقات المستخدمين عن هذا المكان.
requestedLanguage
النوع: string optional
اللغة المطلوبة لهذا المكان.
requestedRegion
النوع: string optional
المنطقة المطلوبة لهذا المكان.
reviews
النوع: Array<Review> optional
قائمة بالتعليقات لهذا المكان.
servesBeer
النوع: boolean optional
ما إذا كان المكان يقدم البيرة. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesBreakfast
النوع: boolean optional
ما إذا كان المكان يقدّم الفطور. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesBrunch
النوع: boolean optional
ما إذا كان المكان يقدم وجبات الإفطار المتأخر. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesDinner
النوع: boolean optional
ما إذا كان المكان يقدّم العشاء أم لا. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesLunch
النوع: boolean optional
ما إذا كان المكان يقدم الغداء. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesVegetarianFood
النوع: boolean optional
ما إذا كان المكان يقدّم مأكولات نباتية. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesWine
النوع: boolean optional
ما إذا كان المكان يقدم النبيذ. لعرض 'true' أو 'false' إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة. لعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
svgIconMaskURI
النوع: string optional
معرف موارد منتظم (URI) لمورد قناع صورة svg الذي يمكن استخدامه لتمثيل فئة مكان.
types
النوع: Array<string> optional
مصفوفة من أنواع هذا المكان (على سبيل المثال، ["political", "locality"] أو ["restaurant", "establishment"]).
userRatingsCount
النوع: number optional
عدد تقييمات المستخدمين التي ساهمت في Place.rating لهذا المكان.
utcOffsetMinutes
النوع: number optional
الفرق من التوقيت العالمي المنسق (UTC) من المنطقة الزمنية الحالية للمكان بالدقائق. على سبيل المثال، التوقيت الصيفي النمساوي الشرقي (GMT+10) بالتوقيت الصيفي يسبق توقيت UTC بمقدار 11 ساعة، وبالتالي يكون utc_offset_minutes 660. بالنسبة إلى المناطق الزمنية وراء التوقيت العالمي المنسق (UTC)، تكون الإزاحة سالبة. على سبيل المثال، utc_offset_minutes هو -60 للرأس الأخضر.
viewport
النوع: LatLngBounds optional
إطار العرض المفضل عند عرض هذا المكان على الخريطة.
websiteURI
النوع: string optional
موقع الويب الموثوق لهذا المكان، مثل الصفحة الرئيسية للنشاط التجاري.
fetchFields
fetchFields(options)
المعلّمات:
قيمة الإرجاع: Promise<{place:Place}>
getNextOpeningTime
getNextOpeningTime([date])
المعلّمات:
  • date:  Date optional
قيمة الإرجاع: Promise<Date optional>
تحسِب الطابع الزمني (بالمللي ثانية منذ البداية، ومناسبة للاستخدام مع new Date()) التي تمثل قيمة OpeningHoursTime التالية. يتم عرض قيمة غير محدّدة إذا كانت البيانات غير كافية لحساب النتيجة أو إذا كان هذا المكان لا يعمل.
isOpen
isOpen([date])
المعلّمات:
  • date:  Date optional الإعدادات التلقائية حتى الآن.
قيمة الإرجاع: Promise<boolean optional>
تحقق مما إذا كان المكان مفتوحًا في تاريخ معين. يتم الحل باستخدام undefined إذا كانت البيانات المعروفة للموقع غير كافية لحساب ذلك، على سبيل المثال إذا كانت ساعات العمل غير مسجّلة.

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" (ويُقصد به الكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").

فئة AddressComponent

google.maps.places.AddressComponent الصف الدراسي

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

فئة الإحالة

google.maps.places.Attribution الصف الدراسي

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {Attribution} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
provider
النوع: string optional
نص الإحالة الذي سيتم عرضه لنتيجة المكان هذه.
providerURI
النوع: string optional

FetchFieldsRequest واجهة

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

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

OpeningHours الفصل الدراسي

google.maps.places.OpeningHours الصف الدراسي

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {OpeningHours} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
periods
فترات الافتتاح التي تغطي كل يوم من الأسبوع، بدءًا من يوم الأحد، بترتيب زمني. لا يتضمن الأيام التي لا يكون المكان فيها مفتوحًا.
weekdayDescriptions
النوع: Array<string>
مصفوفة من سبعة سلاسل تمثل ساعات العمل المنسقة لكل يوم من أيام الأسبوع. ستعمل خدمة الأماكن على تنسيق ساعات العمل وأقلمتها بشكل مناسب للغة الحالية. ويعتمد ترتيب العناصر في هذه المصفوفة على اللغة. تبدأ بعض اللغات الأسبوع من الإثنين، بينما تبدأ لغات أخرى يوم الأحد.

فئة OpeningHoursPeriod

google.maps.places.OpeningHoursPeriod الصف الدراسي

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {OpeningHoursPeriod} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
close
النوع: OpeningHoursPoint optional
تمثل هذه الخاصية وقت إغلاق المكان.
open
النوع: OpeningHoursPoint
تمثّل هذه الخاصية وقت فتح المكان.

فئة OpeningHoursPoint

google.maps.places.OpeningHoursPoint الصف الدراسي

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {OpeningHoursPoint} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
day
النوع: number
يوم الأسبوع، كرقم في النطاق [0، 6]، بدءًا من يوم الأحد. على سبيل المثال، 2 يعني الثلاثاء.
hour
النوع: number
ساعة OpeningHoursPoint.time كرقم، في النطاق [0، 23]. سيتم الإبلاغ عن ذلك حسب المنطقة الزمنية للمكان.
minute
النوع: number
الدقيقة من OpeningHoursPoint.time كرقم، في النطاق [0، 59]. سيتم الإبلاغ عن ذلك حسب المنطقة الزمنية للمكان.

فئة الصورة

google.maps.places.Photo الصف الدراسي

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {Photo} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
attributions
النوع: Array<PhotoAttribution>
نص الإحالة الذي سيتم عرضه لهذه الصورة.
heightPx
النوع: number
ارتفاع الصورة بالبكسل.
widthPx
النوع: number
عرض الصورة بالبكسل.
getURI
getURI([options])
المعلّمات:
قيمة الإرجاع: string
لعرض عنوان URL للصورة المقابل للخيارات المحددة.

فئة ImageAttribution

google.maps.places.PhotoAttribution الصف الدراسي

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {PhotoAttribution} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
author
النوع: string
نص الإحالة المطلوب عرضه لهذه الصورة من الصور.
authorURI
النوع: string optional

PlusCode الفئة

google.maps.places.PlusCode الصف الدراسي

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {PlusCode} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
compoundCode
النوع: string optional
رمز علامة زائد 1/8000 من الدرجة 1/8000 من مساحة الدرجة حيث يتم تجاهل الأحرف الأربعة الأولى (رمز المنطقة) واستبدالها بوصف محلي. على سبيل المثال، "9G8F+5W زيوريخ، سويسرا".
globalCode
النوع: string optional
رمز علامة زائد 1/8000 من الدرجة العلمية في 1/8000 من مساحة الدرجة. على سبيل المثال، "8FVC9G8F+5W".

مراجعة

google.maps.places.Review الصف الدراسي

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {Review} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
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".