Place

فئة مكان

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم 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
تمثيل عنوان المكان بتنسيق adr Microformat.
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 إذا لم يتم طلب هذا الحقل بعد.
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
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
الفرق بين التوقيت العالمي المنسَّق (UTC) للمنطقة الزمنية الحالية للمكان، بالدقائق. على سبيل المثال، توقيت التوقيت الشرقي الرسمي في النمسا (GMT+10) في التوقيت الصيفي يسبق التوقيت العالمي المنسّق (UTC) بمقدار 11 ساعة، وبالتالي سيكون utc_offset_minutes هو 660. بالنسبة إلى المناطق الزمنية متأخرة عن التوقيت العالمي المنسَّق (UTC)، تكون المعادلة سالبة. على سبيل المثال، تشير قيمة 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)، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD) في المملكة المتحدة هو uk (.co.uk)، ورمز ISO 3166-1 هو gb (فنيًا كيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").

AccessibilityOptions

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم 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)

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم 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

AuthorAttribution

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

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

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

ConnectorAggregation

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

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم 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

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

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم 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 نظام شحن مُجمَّع (AC وDC). استنادًا إلى موصّل SAE Type-1 J-1772.
CCS_COMBO_2 نظام شحن مُجمَّع (AC وDC). استنادًا إلى موصِّل النوع 2 Mennekes
CHADEMO موصِّل نوع CHAdeMO
J1772 موصل J1772 من النوع 1.
OTHER أنواع الموصلات الأخرى.
TESLA موصل TESLA العام. وتتوفر هذه المنصة في أمريكا الشمالية، ولكنها قد لا تتبع معيار NACS في أجزاء أخرى من العالم (على سبيل المثال، CCS Combo 2 (CCS2) أو GB/T). تعتبر هذه القيمة أقل تمثيلاً لنوع الموصل الفعلي، وتمثل بشكل أكبر القدرة على شحن مركبة علامة Tesla التجارية في محطة شحن تملكها Tesla.
TYPE_2 موصّل IEC 62196 من النوع 2. وغالبًا ما يُشار إليه باسم 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)

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

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

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

فئة FuelPrice

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

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم 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 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
TRUCK_DIESEL شاحنة ديزل.

مال

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

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم 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

صف واحد (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]. سيتم الإبلاغ عن ذلك حسب المنطقة الزمنية للمكان.

ParkingOptions

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم 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

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم 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)

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

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

فئة PlusCode

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

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

compoundCode
النوع:  string optional
رمز Plus Codes بقياس 1/8000 من درجة x 1/8000 من منطقة الدرجة حيث يتم إسقاط الأحرف الأربعة الأولى (رمز المنطقة) واستبدالها بوصف المنطقة المحلية. على سبيل المثال، "9G8F+5W Zurich, سويسرا".
globalCode
النوع:  string optional
رمز Plus Codes بقياس 1/8000 من درجة x 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)

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم 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
رمز البلد أو المنطقة (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، سيظهر خطأ ضياء_أمل.
excludedTypes optional
النوع:  Array<string> optional
نوع المكان المستبعَد. راجع القائمة الكاملة للأنواع المدعومة. يمكن أن يضم المكان أنواعًا عديدة مختلفة من الأماكن. ويمكن تحديد ما يصل إلى 50 نوعًا. إذا حدّدت النوع نفسه في كل من القائمتين included وexcluded، سيظهر خطأ ضياء_أمل.
includedPrimaryTypes optional
النوع:  Array<string> optional
تم تضمين نوع المكان الأساسي. راجع القائمة الكاملة للأنواع المدعومة. لا يمكن أن يحتوي المكان إلا على نوع أساسي واحد. ويمكن تحديد ما يصل إلى 50 نوعًا. إذا حدّدت النوع نفسه في كل من القائمتين included وexcluded، سيظهر خطأ ضياء_أمل.
includedTypes optional
النوع:  Array<string> optional
نوع المكان المضمّن. راجع القائمة الكاملة للأنواع المدعومة. يمكن أن يضم المكان أنواعًا عديدة مختلفة من الأماكن. ويمكن تحديد ما يصل إلى 50 نوعًا. إذا حدّدت النوع نفسه في كل من القائمتين included وexcluded، سيظهر خطأ ضياء_أمل.
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 ثابت

تعداد الترتيب الخاص بطلب البحث عن قرب

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

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