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
تمثيل عنوان المكان في تنسيق DKIM.
allowsDogs
النوع:  boolean optional
attributions
النوع:  Array<Attribution> optional
نص الإحالة الذي سيتم عرضه لنتيجة المكان هذه.
businessStatus
النوع:  BusinessStatus optional
حالة تشغيل الموقع الجغرافي null إذا لم تكن هناك حالة معروفة. undefined إذا لم يتم تحميل بيانات الحالة من الخادم.
displayName
النوع:  string optional
الاسم المعروض للموقع الجغرافي null في حال عدم توفّر اسم. undefined إذا لم يتم تحميل بيانات الاسم من الخادم.
editorialSummary
النوع:  string optional
تمثّل هذه السمة الملخص التحريري لهذا المكان. null في حال عدم توفُّر ملخّص تحريري. undefined إذا لم يتم طلب هذا الحقل بعد.
editorialSummaryLanguageCode
النوع:  string optional
لغة الملخص التحريري لهذا المكان. null في حال عدم توفُّر ملخّص تحريري. undefined إذا لم يتم طلب هذا الحقل بعد.
formattedAddress
النوع:  string optional
عنوان المواقع الجغرافية بالكامل.
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" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasWiFi
النوع:  boolean optional
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
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
معادلة التوقيت العالمي المنسَّق (UTC) للمنطقة الزمنية الحالية للمكان، بالدقائق. على سبيل المثال، توقيت شرق النمسا الرسمي (GMT+10) في التوقيت الصيفي يسبق التوقيت العالمي المنسَّق (UTC) بمقدار 11 ساعة، وبالتالي سيكون utc_offset_minutes هو 660. بالنسبة إلى المناطق الزمنية وراء التوقيت العالمي المنسَّق، تكون الإزاحة سالبة. على سبيل المثال، utc_offset_minutes هو -60 للرأس الأخضر.
viewport
النوع:  LatLngBounds optional
إطار العرض المفضل عند عرض هذا "المكان" على الخريطة.
websiteURI
النوع:  string optional
الموقع الإلكتروني الموثوق به لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري
openingHours
النوع:  OpeningHours optional
fetchFields
fetchFields(options)
المَعلمات: 
قيمة الإرجاع:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
المَعلمات: 
  • dateDate optional
قيمة الإرجاع:  Promise<Date optional>
تحسب التاريخ الذي يمثل OpeningHoursTime التالي. عرض غير محدّد إذا كانت البيانات غير كافية لحساب النتيجة، أو إذا كان هذا المكان غير عامل.
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" (من الناحية التقنية لكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").

فئة 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>
مصفوفة من السلاسل تشير إلى نوع مكوِّن العنوان هذا. يمكنك العثور على قائمة بالأنواع الصالحة هنا.

فئة الإحالة

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

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

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

واجهة FetchFieldsRequest

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

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

fields
النوع:  Array<string>
قائمة الحقول التي سيتم استرجاعها

صف OpeningHours

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

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

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

فئة OpeningHoursPeriod

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

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

close
النوع:  OpeningHoursPoint optional
تمثّل هذه السمة وقت إغلاق المكان.
open
النوع:  OpeningHoursPoint
تمثّل هذه السمة وقت فتح المكان.

حصة OpeningHoursPoint

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

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

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

ParkingOptions

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

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

hasFreeGarageParking
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر مواقف مجانية للسيارات في مرآب. عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.
hasFreeParkingLot
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر مواقف مجانية للسيارات. عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.
hasFreeStreetParking
النوع:  boolean optional
ما إذا كان المكان يقدّم مواقف مجانية للسيارات في الشارع عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.
hasPaidGarageParking
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر مواقف مدفوعة للسيارات في مرآب عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.
hasPaidParkingLot
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر مواقف سيارات برسوم مدفوعة. عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.
hasPaidStreetParking
النوع:  boolean optional
ما إذا كان المكان يتوفّر فيه موقف سيارات مدفوع في الشارع عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.
hasValetParking
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر خدمة صفّ السيارات من قِبل موظفي الفندق. عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.

فئة PaymentOptions

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

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

acceptsCashOnly
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقبل الدفع نقدًا فقط. عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.
acceptsCreditCards
النوع:  boolean optional
ما إذا كان المكان يقبل الدفع عبر بطاقة ائتمان عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.
acceptsDebitCards
النوع:  boolean optional
ما إذا كان المكان يقبل الدفع عبر بطاقة السحب الآلي عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.
acceptsNFC
النوع:  boolean optional
ما إذا كان المكان يقبل الدفع عبر تقنية NFC. عرض "صحيح" أو "خطأ" إذا كانت القيمة معروفة. لعرض "null" إذا كانت القيمة غير معروفة.

فصل الصور

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

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

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

فئة AuthorAttribution

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

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

displayName
النوع:  string
اسم المؤلف لهذه النتيجة.
photoURI
النوع:  string optional
معرّف الموارد المنتظم (URI) لصورة المؤلف لهذه النتيجة. وقد لا تكون هذه الميزة متوفّرة في بعض الأحيان.
uri
النوع:  string optional
عنوان URI للملف الشخصي للمؤلف لهذه النتيجة.

فئة PlusCode

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

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

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

مراجعة الصف

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

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

authorAttribution
النوع:  AuthorAttribution optional
المراجع.
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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

واجهة SearchByTextRequest

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

طلب واجهة لـ Place.searchByText.

fields
النوع:  Array<string>
الحقول التي سيتم تضمينها في الرد، والتي سيتم تحصيل رسومها. في حال اجتياز ['*']، سيتم عرض جميع الحقول المتاحة وتحصيل الرسوم مقابلها (لا يُنصَح بهذا الإجراء لعمليات نشر الإنتاج). للحصول على قائمة بالحقول، يُرجى الاطّلاع على PlaceResult. يمكن تحديد الحقول المتداخلة باستخدام مسارات النقاط (مثل "geometry.location").
includedType optional
النوع:  string optional
نوع المكان المطلوب. القائمة الكاملة للأنواع المتوافقة: https://developers.google.com/maps/documentation/places/web-service/place-types. يمكن استخدام نوع واحد فقط مضمَّن. عرض SearchByTextRequest.useStrictTypeFiltering
isOpenNow optional
النوع:  boolean optional
الخيار التلقائي: false
يُستخدم لحصر البحث على الأماكن المفتوحة حاليًا.
language optional
النوع:  string optional
سيتم عرض تفاصيل المكان باللغة المفضّلة إن توفّرت. سيتم الإعداد التلقائي على الإعدادات المفضّلة للغة المتصفّح. القائمة الحالية باللغات المعتمدة: https://developers.google.com/maps/faq#languagesupport.
locationBias optional
المنطقة المراد البحث فيها. هذا الموقع بمثابة تحيز مما يعني أنه قد يتم عرض النتائج حول موقع معين. لا يمكن الضبط مع locationRestriction.
locationRestriction optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
المنطقة المراد البحث فيها. يمثل هذا الموقع الجغرافي قيدًا مما يعني أنه لن يتم عرض النتائج خارج هذا الموقع الجغرافي. لا يمكن الضبط مع locationBias.
maxResultCount optional
النوع:  number optional
الحد الأقصى لعدد النتائج المطلوب عرضها. ويجب أن تتراوح القيمة بين 1 و20، بشكلٍ شامل.
minRating optional
النوع:  number optional
يمكنك تصفية النتائج التي يقل متوسط تقييم المستخدمين فيها عن هذا الحدّ الأقصى تمامًا. يجب أن تكون القيمة الصالحة عائمة بين 0 و5 (بشكل شامل) بوتيرة 0.5، أي [0، 0.5، 1.0، ... ، 5.0] بشكل شامل. سيتم تقريب تقييم الإدخال إلى أقرب 0.5(سقف). على سبيل المثال، سيؤدي التقييم 0.6 إلى إزالة جميع النتائج ذات التقييم الأقل من 1.0.
priceLevels optional
النوع:  Array<PriceLevel> optional
يُستخدم لتقييد البحث على الأماكن التي تم وضع علامة عليها كمستويات أسعار معيّنة. ويمكن اختيار أي مجموعات من مستويات الأسعار. يتم ضبط الإعدادات تلقائيًا على جميع مستويات السعر.
query optional
النوع:  string optional
BetarankBy optional
النوع:  SearchByTextRankPreference optional
rankPreference optional
النوع:  SearchByTextRankPreference optional
الخيار التلقائي: SearchByTextRankPreference.DISTANCE
كيفية ترتيب النتائج في الردّ
region optional
النوع:  string optional
رمز البلد/المنطقة يونيكود (CLDR) للموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بمنطقة معيّنة، إذا كان متاحًا. يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري. لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. تجدر الإشارة إلى أنّه لا يمكن حاليًا استخدام رموز المناطق المكوَّنة من 3 أرقام.
textQuery optional
النوع:  string optional
مطلوبة. طلب البحث النصي للبحث النصي.
useStrictTypeFiltering optional
النوع:  boolean optional
الخيار التلقائي: false
يُستخدَم هذا الخيار لضبط فلترة الأنواع المتشدّدة لـ SearchByTextRequest.includedType. إذا تم ضبطها على "صحيح"، سيتم عرض النتائج من النوع نفسه فقط.

ثابت SearchByTextRankPreference

google.maps.places.SearchByTextRankPreference ثابت

تعداد RankPreferences لـ SearchByTextRequest.

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

DISTANCE يعمل على ترتيب النتائج حسب المسافة.
RELEVANCE يعمل على ترتيب النتائج حسب مدى صلتها بموضوع البحث.

واجهة SearchNearbyRequest

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

طلب واجهة لـ Place.searchNearby. لمزيدٍ من المعلومات عن الطلب، يُرجى الاطّلاع على مرجع واجهة برمجة تطبيقات الأماكن.

fields
النوع:  Array<string>
الحقول التي سيتم تضمينها في الرد، والتي سيتم تحصيل رسومها. في حال اجتياز ['*']، سيتم عرض جميع الحقول المتاحة وتحصيل الرسوم مقابلها (لا يُنصَح بهذا الإجراء لعمليات نشر الإنتاج). للحصول على قائمة بالحقول، يُرجى الاطّلاع على PlaceResult. يمكن تحديد الحقول المتداخلة باستخدام مسارات النقاط (مثل "geometry.location").
locationRestriction
النوع:  Circle|CircleLiteral
المنطقة المطلوب البحث عنها، يتم تحديدها كدائرة لها مركز ونصف قطر. ولا يتم عرض النتائج خارج الموقع الجغرافي المحدَّد.
excludedPrimaryTypes optional
النوع:  Array<string> optional
تم استبعاد نوع المكان الأساسي. اطّلِع على القائمة الكاملة للأنواع المتاحة. يمكن أن يكون للمكان نوع أساسي واحد فقط. ويمكن تحديد ما يصل إلى 50 نوعًا. إذا حددت النوع نفسه في كل من القائمتين included وexcluded، فسيتم عرض خطأ تفصيلية FIA.
includedPrimaryTypes optional
النوع:  Array<string> optional
تم تضمين نوع المكان الأساسي. اطّلِع على القائمة الكاملة للأنواع المتاحة. يمكن أن يكون للمكان نوع أساسي واحد فقط. ويمكن تحديد ما يصل إلى 50 نوعًا. إذا حددت النوع نفسه في كل من القائمتين included وexcluded، فسيتم عرض خطأ تفصيلية FIA.
includedTypes optional
النوع:  Array<string> optional
نوع المكان المضمّن اطّلِع على القائمة الكاملة للأنواع المتاحة. يمكن أن يضم المكان أنواعًا مختلفة من الأماكن. ويمكن تحديد ما يصل إلى 50 نوعًا. إذا حددت النوع نفسه في كل من القائمتين included وexcluded، فسيتم عرض خطأ تفصيلية FIA.
language optional
النوع:  string optional
سيتم عرض تفاصيل المكان باللغة المفضّلة إن توفّرت. سيتم الإعداد التلقائي على الإعدادات المفضّلة للغة المتصفّح. القائمة الحالية باللغات المعتمدة: https://developers.google.com/maps/faq#languagesupport.
maxResultCount optional
النوع:  number optional
الحد الأقصى لعدد النتائج المطلوب عرضها. ويجب أن تتراوح القيمة بين 1 و20، بشكلٍ شامل.
rankPreference optional
النوع:  SearchNearbyRankPreference optional
الخيار التلقائي: SearchNearbyRankPreference.DISTANCE
كيفية ترتيب النتائج في الردّ
region optional
النوع:  string optional
رمز البلد/المنطقة يونيكود (CLDR) للموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بمنطقة معيّنة، إذا كان متاحًا. يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري. لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. تجدر الإشارة إلى أنّه لا يمكن حاليًا استخدام رموز المناطق المكوَّنة من 3 أرقام.

ثابت SearchNearbyRankPreference

google.maps.places.SearchNearbyRankPreference ثابت

تعداد RankPreferences لـ SearchSpamRequest.

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

DISTANCE يعمل على ترتيب النتائج حسب المسافة.
POPULARITY لترتيب النتائج حسب رواجها.