Place

Place class

google.maps.places.Place class

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

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
تمثيل عنوان المكان في تنسيق dr المصغر.
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
تُستخدَم لتحديد ما إذا كان المكان يقدّم خدمة الاستلام من السيارة. تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة. تعرِض هذه السمة القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasDelivery
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم خدمة توصيل الطلبات. تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة. تعرِض هذه السمة القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasDineIn
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم خدمة تناول الطعام داخله. تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة. تعرِض هذه السمة القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasLiveMusic
النوع:  boolean optional
hasMenuForChildren
النوع:  boolean optional
hasOutdoorSeating
النوع:  boolean optional
hasRestroom
النوع:  boolean optional
hasTakeout
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يوفّر خدمة تناول الطعام في الخارج. تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة. تعرِض هذه السمة القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
hasWiFi
النوع:  boolean optional
iconBackgroundColor
النوع:  string optional
رمز اللون السداسي العشري التلقائي لفئة المكان
id
النوع:  string
معرّف المكان الفريد
internationalPhoneNumber
النوع:  string optional
رقم هاتف المكان بالتنسيق الدولي يتضمّن التنسيق الدولي رمز البلد، ويتمّ وضع علامة الجمع (+) قبله.
isGoodForChildren
النوع:  boolean optional
isGoodForGroups
النوع:  boolean optional
isGoodForWatchingSports
النوع:  boolean optional
isReservable
النوع:  boolean optional
ما إذا كان المكان يتيح الحجز تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "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
ما إذا كان المكان يقدّم البيرة تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة. تعرِض هذه السمة القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesBreakfast
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم وجبة الإفطار. تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة. تعرِض هذه السمة القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesBrunch
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم وجبات الإفطار المتأخر. تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة. تعرِض هذه السمة القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
servesCocktails
النوع:  boolean optional
servesCoffee
النوع:  boolean optional
servesDessert
النوع:  boolean optional
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"])
userRatingCount
النوع:  number optional
عدد تقييمات المستخدمين التي ساهمت في Place.rating هذا "المكان"
utcOffsetMinutes
النوع:  number optional
التوقيت المحلي للمكان مقارنةً بالتوقيت العالمي المنسق، بالكيلومترات على سبيل المثال، توقيت شرق أستراليا الرسمي (التوقيت العالمي المنسق +10) في التوقيت الصيفي يسبق التوقيت العالمي المنسق بـ 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) المكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو uk (.co.uk) بينما رمزه وفقًا لمعيار ISO 3166-1 هو gb (للجهة المعروفة رسميًا باسم "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").

AccessibilityOptions class

google.maps.places.AccessibilityOptions class

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

hasWheelchairAccessibleEntrance
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يتضمّن مدخلًا مناسبًا لأصحاب الكراسي المتحركة. تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة.
hasWheelchairAccessibleParking
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يتوفّر فيه موقف سيارات مناسب لأصحاب الكراسي المتحركة. تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة.
hasWheelchairAccessibleRestroom
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يتضمّن دورة مياه مناسبة لأصحاب الكراسي المتحرّكة. تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة.
hasWheelchairAccessibleSeating
النوع:  boolean optional
تُستخدَم لتحديد ما إذا كان المكان يقدّم أماكن جلوس مناسبة لأصحاب الكراسي المتحركة. تعرِض هذه الدالة القيمة "true" أو "false" إذا كانت القيمة معروفة. يتم عرض "null" إذا كانت القيمة غير معروفة.

فئة AddressComponent

google.maps.places.AddressComponent class

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

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

Attribution class

google.maps.places.Attribution class

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

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

فئة AuthorAttribution

google.maps.places.AuthorAttribution class

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

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

فئة ConnectorAggregation

google.maps.places.ConnectorAggregation class

معلومات شحن المركبات الكهربائية، مجمّعة للوصلات من النوع نفسه ومعدّل الشحن نفسه

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

availabilityLastUpdateTime
النوع:  Date optional
الوقت الذي تم فيه آخر تعديل لمعلومات مدى توفّر الموصّل في هذه التجميعة
availableCount
النوع:  number optional
عدد أدوات الربط المتاحة حاليًا في هذه التجميعة
count
النوع:  number
عدد الموصّلات في هذه التجميعة
maxChargeRateKw
النوع:  number
الحد الأقصى الثابت لمعدّل الشحن بالكيلوواط لكل موصل من عملية التجميع
outOfServiceCount
النوع:  number optional
عدد الموصّلات في هذه المجموعة غير متوفّرة حاليًا.
type
النوع:  EVConnectorType optional
نوع الموصّل لهذا التجميع.

EVChargeOptions class

google.maps.places.EVChargeOptions class

معلومات عن محطة شحن المركبات الكهربائية المستضافة في المكان

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

connectorAggregations
قائمة بتجميعات وصلات شحن المركبات الكهربائية التي تحتوي على وصلات من النوع نفسه ومعدّل الشحن نفسه
connectorCount
النوع:  number
عدد الموصّلات في هذه المحطة بما أنّ بعض المنافذ يمكن أن تتضمّن عدة موصلات ولكن لا يمكنها شحن سوى سيارة واحدة في المرة الواحدة، قد يكون عدد الموصّلات أكبر من إجمالي عدد السيارات التي يمكن شحنها في الوقت نفسه.

متغيّرات EVConnectorType الثابتة

google.maps.places.EVConnectorType الثوابت

أنواع وصلات شحن المركبات الكهربائية

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

CCS_COMBO_1 نظام الشحن المدمج (التيار المتردّد والثابت) استنادًا إلى موصل SAE Type-1 J-1772
CCS_COMBO_2 نظام الشحن المدمج (التيار المتردّد والثابت) استنادًا إلى موصّل من النوع 2 من Mennekes
CHADEMO موصّل من النوع CHAdeMO
J1772 موصل J1772 من النوع 1
OTHER أنواع الموصّلات الأخرى
TESLA موصل TESLA العام يُستخدم هذا المعيار في أمريكا الشمالية، ولكن قد لا يكون معتمدًا في أجزاء أخرى من العالم (مثل CCS Combo 2 (CCS2) أو GB/T). لا تمثّل هذه القيمة نوع الموصّل الفعلي، بل تمثّل بشكل أكبر إمكانية شحن مركبة من علامة Tesla التجارية في محطة شحن مملوكة لشركة Tesla.
TYPE_2 موصل من النوع 2 وفقًا لمعيار IEC 62196 يُشار إليها غالبًا باسم MENNEKES.
UNSPECIFIED_GB_T يتوافق نوع GB/T مع معيار GB/T في الصين. يشمل هذا النوع جميع أنواع GB_T.
UNSPECIFIED_WALL_OUTLET مقبس حائط غير محدَّد

EVSearchOptions واجهة

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

الخيارات المتعلّقة بالمركبات الكهربائية التي يمكن تحديدها لطلب البحث عن مكان

connectorTypes optional
النوع:  Array<EVConnectorType> optional
قائمة أنواع وصلات المركبات الكهربائية المفضّلة تتم فلترة المكان الذي لا يتيح استخدام أيّ من أنواع الموصّلات المدرَجة.
minimumChargingRateKw optional
النوع:  number optional
الحد الأدنى لمعدل الشحن المطلوب بالكيلوواط يتم استبعاد مكان يقلّ فيه سعر الشحن عن السعر المحدّد.

واجهة FetchFieldsRequest

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

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

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

فئة FuelOptions

google.maps.places.FuelOptions class

أحدث المعلومات عن خيارات الوقود في محطة وقود ويتم تعديل هذه المعلومات بانتظام.

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

fuelPrices
النوع:  Array<FuelPrice>
قائمة بأسعار الوقود لكل نوع من أنواع الوقود التي توفّرها هذه المحطة، إدخال واحد لكل نوع من أنواع الوقود

FuelPrice class

google.maps.places.FuelPrice class

معلومات عن سعر الوقود لنوع معيّن من الوقود

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

price
النوع:  Money optional
سعر الوقود
type
النوع:  FuelType optional
نوع الوقود
updateTime
النوع:  Date optional
وقت آخر تعديل لسعر الوقود

FuelType الثوابت

google.maps.places.FuelType الثوابت

أنواع الوقود

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

BIO_DIESEL الديزل الحيوي
DIESEL وقود الديزل
E80 ‫E 80
E85 ‫E 85
LPG غاز البترول المسال
METHANE الميثان
MIDGRADE متوسط
PREMIUM Premium
REGULAR_UNLEADED بنزين عادي غير مزوّد بالرصاص
SP100 ‫SP 100
SP91 SP 91.
SP91_E10 ‫SP 91 E10
SP92 الإصدار 92 من حزمة الخدمة
SP95 SP 95
SP95_E10 ‫SP95 E10
SP98 SP 98.
SP99 SP 99.
TRUCK_DIESEL وقود الديزل للشاحنات

صف الأرباح

google.maps.places.Money class

تمثيل لمبلغ مالي مع نوع العملة

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

currencyCode
النوع:  string
رمز العملة المكوّن من ثلاثة أحرف، والمحدّد في معيار ISO 4217
nanos
النوع:  number
عدد وحدات النانو (10^-9) للمبلغ
units
النوع:  number
الوحدات الكاملة للمبلغ على سبيل المثال، إذا كان Money.currencyCode هو "USD"، تكون الوحدة الواحدة دولار أمريكي واحد.
toString
toString()
المَعلمات:  بدون
القيمة المعروضة:  string
لعرض تمثيل يمكن لشخص عادي قراءته لمبلغ المال مع رمز العملة

OpeningHours class

google.maps.places.OpeningHours class

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

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

OpeningHoursPeriod class

google.maps.places.OpeningHoursPeriod class

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

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

OpeningHoursPoint class

google.maps.places.OpeningHoursPoint class

يمكنك الوصول إليه من خلال الاتصال بالرقم 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] وسيتم تسجيل ذلك في المنطقة الزمنية للمكان.

ParkingOptions class

google.maps.places.ParkingOptions class

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

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

PaymentOptions class

google.maps.places.PaymentOptions class

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

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

فئة الصورة

google.maps.places.Photo class

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

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

PlusCode class

google.maps.places.PlusCode class

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

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

PriceLevel الثوابت

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

قائمة بفئات مستوى السعر لكائنات "الأماكن"

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

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

مراجعة الفئة

google.maps.places.Review class

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

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.

واجهة SearchByTextRequest

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

طلب واجهة Place.searchByText

fields
النوع:  Array<string>
الحقول التي سيتم تضمينها في الردّ والتي سيتمّ تحصيل رسومها في حال تمّ إدخال ['*']، سيتمّ عرض جميع الحقول المتاحة وسيتمّ تحصيل رسوم مقابلها (لا يُنصح بذلك في عمليات النشر في مرحلة الإنتاج). يمكنك طلب أيّ سمة في فئة Place كسمة حقل.
evSearchOptions optional
النوع:  EVSearchOptions optional
الخيارات المتعلّقة بالمركبات الكهربائية التي يمكن تحديدها لطلب البحث عن مكان
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.RELEVANCE
كيفية ترتيب النتائج في الردّ
region optional
النوع:  string optional
رمز البلد أو المنطقة بترميز Unicode (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 الثوابت

تَعداد RankPreference لفئة SearchByTextRequest

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

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

واجهة SearchNearbyRequest

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

طلب واجهة Place.searchNearby لمزيد من المعلومات عن الطلب، يُرجى الاطّلاع على مرجع Places API.

fields
النوع:  Array<string>
الحقول التي سيتم تضمينها في الردّ والتي سيتمّ تحصيل رسومها في حال تمّ إدخال ['*']، سيتمّ عرض جميع الحقول المتاحة وسيتمّ تحصيل رسوم مقابلها (لا يُنصح بذلك في عمليات النشر في مرحلة الإنتاج). يمكنك طلب أيّ سمة في فئة Place كسمة حقل.
locationRestriction
النوع:  Circle|CircleLiteral
المنطقة التي تريد البحث فيها، والتي يتم تحديدها على أنّها دائرة لها مركز ونطاق لا يتم عرض النتائج خارج الموقع الجغرافي المحدَّد.
excludedPrimaryTypes optional
النوع:  Array<string> optional
تم استبعاد نوع المكان الأساسي. اطّلِع على القائمة الكاملة بالأنواع المتوافقة. يمكن أن يكون للمكان نوع أساسي واحد فقط. يمكن تحديد ما يصل إلى 50 نوعًا. إذا حدّدت النوع نفسه في كلّ من القائمتَين included وexcluded، يتم عرض الخطأ INVALID_ARGUMENT.
excludedTypes optional
النوع:  Array<string> optional
نوع المكان المستبعَد اطّلِع على القائمة الكاملة بالأنواع المتوافقة. يمكن أن يتضمّن المكان العديد من أنواع الأماكن المختلفة. يمكن تحديد ما يصل إلى 50 نوعًا. إذا حدّدت النوع نفسه في كلّ من القائمتَين included وexcluded، يتم عرض الخطأ INVALID_ARGUMENT.
includedPrimaryTypes optional
النوع:  Array<string> optional
تم تضمين نوع المكان الأساسي. اطّلِع على القائمة الكاملة بالأنواع المتوافقة. يمكن أن يكون للمكان نوع أساسي واحد فقط. يمكن تحديد ما يصل إلى 50 نوعًا. إذا حدّدت النوع نفسه في كلّ من القائمتَين included وexcluded، يتم عرض الخطأ INVALID_ARGUMENT.
includedTypes optional
النوع:  Array<string> optional
نوع المكان المضمّن اطّلِع على القائمة الكاملة بالأنواع المتوافقة. يمكن أن يتضمّن المكان العديد من أنواع الأماكن المختلفة. يمكن تحديد ما يصل إلى 50 نوعًا. إذا حدّدت النوع نفسه في كلّ من القائمتَين included وexcluded، يتم عرض الخطأ INVALID_ARGUMENT.
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
رمز البلد أو المنطقة بترميز Unicode (CLDR) للموقع الجغرافي الذي يتم منه إرسال الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بالمنطقة، إن توفّر. يمكن أن تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري. لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. يُرجى العِلم أنّ رموز المناطق المكونة من 3 أرقام غير متاحة حاليًا.

SearchNearbyRankPreference الثوابت

google.maps.places.SearchNearbyRankPreference الثوابت

تسرد هذه السمة الثابتة RankPreference لطلب SearchNearbyRequest.

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

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