فئة المكان
صف واحد (google.maps.places.Place
)
يمكنك الوصول من خلال الاتصال على الرقم const {Place} = await google.maps.importLibrary("places")
. يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
الشركة المصنِّعة | |
---|---|
Place |
Place(options) المَعلمات:
|
طرق ثابتة | |
---|---|
searchByText |
searchByText(request) المَعلمات:
البحث عن الأماكن استنادًا إلى طلبات البحث النصية |
searchNearby |
searchNearby(request) المَعلمات:
البحث عن الأماكن المجاورة |
أماكن إقامة | |
---|---|
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 |
صور لهذا المكان ستحتوي المجموعة على ما يصل إلى عشرة عناصر Photo . |
plusCode |
النوع:
PlusCode optional |
priceLevel |
النوع:
PriceLevel optional مستوى سعر المكان. يمكن أن تعرض هذه السمة أيًا من القيم التالية
|
rating |
النوع:
number optional تقييم يتراوح من 1.0 إلى 5.0 استنادًا إلى مراجعات المستخدمين لهذا المكان. |
regularOpeningHours |
النوع:
OpeningHours optional |
requestedLanguage |
النوع:
string optional اللغة المطلوبة لهذا المكان. |
requestedRegion |
النوع:
string optional المنطقة المطلوبة لهذا المكان. |
reviews |
قائمة بالمراجعات لهذا المكان. |
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 optional |
الطُرق | |
---|---|
fetchFields |
fetchFields(options) المَعلمات:
|
getNextOpeningTime |
getNextOpeningTime([date]) المَعلمات:
تحسب التاريخ الذي يمثل OpeningHoursTime التالي. عرض غير محدّد إذا كانت البيانات غير كافية لحساب النتيجة، أو إذا كان هذا المكان غير عامل. |
isOpen |
isOpen([date]) المَعلمات:
قيمة الإرجاع:
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 |
النوع:
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 يُستخدم لتقييد البحث على الأماكن التي تم وضع علامة عليها كمستويات أسعار معيّنة. ويمكن اختيار أي مجموعات من مستويات الأسعار. يتم ضبط الإعدادات تلقائيًا على جميع مستويات السعر. |
|
النوع:
string 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 |
لترتيب النتائج حسب رواجها. |