إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل هذا النمط في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد لمنصّة "خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Place

Place class

google.maps.places.Place class

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

الشركة المصنِّعة
`Place`	`Place(options)` المَعلمات: `options`: `PlaceOptions`

الطرق الثابتة
`searchByText`	`searchByText(request)` المَعلمات: `request`: `SearchByTextRequest` القيمة المعروضة: `Promise<{places:Array<Place>}>` البحث عن الأماكن استنادًا إلى طلب بحث نصي
`searchNearby`	`searchNearby(request)` المَعلمات: `request`: `SearchNearbyRequest` القيمة المعروضة: `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` إذا لم يتم تحميل بيانات الاسم من الخادم
`editorialSummary`	النوع: `string optional` الملخّص التحريري لهذا المكان `null` إذا لم يكن هناك ملخّص تحريري `undefined` إذا لم يتم طلب هذا الحقل بعد
`editorialSummaryLanguageCode`	النوع: `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" إذا كانت القيمة غير معروفة. تعرِض هذه السمة القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`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` التوقيت المحلي للمكان مقارنةً بالتوقيت العالمي المنسق، بالكيلومترات على سبيل المثال، توقيت شرق أستراليا الرسمي (التوقيت العالمي المنسق +10) في التوقيت الصيفي يسبق التوقيت العالمي المنسق بـ 11 ساعة، لذا سيكون `utc_offset_minutes` هو `660`. بالنسبة إلى المناطق الزمنية التي تسبق التوقيت العالمي المنسق، يكون الفارق سلبيًا. على سبيل المثال، `utc_offset_minutes` هو `-60` للرأس الأخضر.
`viewport`	النوع: `LatLngBounds optional` مساحة العرض المفضّلة عند عرض هذا "المكان" على الخريطة
`websiteURI`	النوع: `string optional` الموقع الإلكتروني الموثوق به لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري
`openingHours`	تم إيقافها نهائيًا: استخدِم `Place.regularOpeningHours` بدلاً منها. النوع: `OpeningHours optional`

الطُرق
`fetchFields`	`fetchFields(options)` المَعلمات: `options`: `FetchFieldsRequest` القيمة المعروضة: `Promise<{place:Place}>`
`getNextOpeningTime`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `getNextOpeningTime([date])` المَعلمات: `date`: `Date optional` القيمة المعروضة: `Promise<Date optional>` لحساب التاريخ الذي يمثّل OpeningHoursTime التالي. يتم عرض قيمة غير محدّدة إذا كانت البيانات غير كافية لاحتساب النتيجة أو إذا لم يكن هذا المكان قيد التشغيل.
`isOpen`	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. `isOpen([date])` المَعلمات: `date`: `Date 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`

واجهة FetchFieldsRequest

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

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

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

OpeningHours class

google.maps.places.OpeningHours class

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

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

الخصائص

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])` المَعلمات: `options`: `PhotoOptions optional` القيمة المعروضة: `string` تعرِض هذه السمة عنوان URL للصورة المطابق للخيارات المحدّدة.

فئة AuthorAttribution

google.maps.places.AuthorAttribution class

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

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

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".

مراجعة الفئة

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.

PriceLevel الثوابت

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

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

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

الثوابت
`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`	النوع: `LatLng\|LatLngLiteral\|LatLngBounds\|LatLngBoundsLiteral\|CircleLiteral\|Circle 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`	متوقفة نهائيًا: يُرجى استخدام textQuery بدلاً من ذلك. النوع: `string optional`
`rankBy optional`	متوقف نهائيًا: يُرجى استخدام rankPreference بدلاً من ذلك. ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. النوع: `SearchByTextRankPreference optional`
`rankPreference optional`	النوع: `SearchByTextRankPreference optional` القيمة التلقائية: `SearchByTextRankPreference.DISTANCE` كيفية ترتيب النتائج في الردّ
`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>` الحقول التي سيتم تضمينها في الردّ والتي سيتمّ تحصيل رسومها في حال تمّ إدخال `['*']`، سيتمّ عرض جميع الحقول المتاحة وسيتمّ تحصيل رسوم مقابلها (لا يُنصح بذلك في عمليات النشر في مرحلة الإنتاج). للحصول على قائمة بالحقول، اطّلِع على `PlaceResult`. يمكن تحديد الحقول المضمّنة باستخدام مسارات النقاط (على سبيل المثال، `"geometry.location"`).
`locationRestriction`	النوع: `Circle\|CircleLiteral` المنطقة التي تريد البحث فيها، والتي يتم تحديدها على أنّها دائرة لها مركز ونطاق لا يتم عرض النتائج خارج الموقع الجغرافي المحدَّد.
`excludedPrimaryTypes 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`	ترتيب النتائج حسب مدى الرواج

Place

Place class

الشركة المصنِّعة

الطرق الثابتة

الخصائص

الطُرق

واجهة PlaceOptions

الخصائص

AccessibilityOptions class

الخصائص

فئة AddressComponent

الخصائص

Attribution class

الخصائص

واجهة FetchFieldsRequest

الخصائص

OpeningHours class

الخصائص

OpeningHoursPeriod class

الخصائص

OpeningHoursPoint class

الخصائص

ParkingOptions class

الخصائص

PaymentOptions class

الخصائص

فئة الصورة

الخصائص

الطُرق

فئة AuthorAttribution

الخصائص

PlusCode class

الخصائص

مراجعة الفئة

الخصائص

PriceLevel الثوابت

الثوابت

واجهة SearchByTextRequest

الخصائص

SearchByTextRankPreference الثوابت

الثوابت

واجهة SearchNearbyRequest

الخصائص

SearchNearbyRankPreference الثوابت

الثوابت