فئة المكان
google.maps.places.Place
صف
تنفّذ هذه الفئة
PlaceOptions.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم 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تمثيل عنوان "المكان" بتنسيق adr المصغّر |
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 إذا لم يتم طلب خيارات الوقود من الخادم. |
googleMapsLinks |
النوع:
GoogleMapsLinks optionalروابط لتنفيذ إجراءات مختلفة على "خرائط Google" |
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" إذا كانت القيمة غير معروفة. تعرِض القيمة "غير محدّد" إذا لم يتم طلب هذا الحقل بعد. |
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 |
postalAddress |
النوع:
PostalAddress optional |
priceLevel |
النوع:
PriceLevel optionalتمثّل هذه السمة مستوى سعر "المكان". يمكن أن تعرض هذه السمة أيًا من القيم التالية
|
priceRange |
النوع:
PriceRange optionalنطاق الأسعار لهذا المكان يمكن عدم ضبط endPrice، ما يشير إلى نطاق بدون حدّ أعلى (مثل "أكثر من 100 دولار أمريكي"). |
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 |
قائمة بالمراجعات الخاصة بهذا المكان |
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تمثّل هذه السمة الفرق بين المنطقة الزمنية الحالية للمكان والتوقيت العالمي المنسّق، وذلك بالدقائق. على سبيل المثال، يسبق توقيت شرق أستراليا الرسمي (GMT+10) التوقيت العالمي المنسَّق بـ 11 ساعة في التوقيت الصيفي، لذا سيكون utc_offset_minutes هو 660. بالنسبة إلى المناطق الزمنية التي تسبق التوقيت العالمي المتفق عليه، يكون فارق التوقيت سالبًا. على سبيل المثال، utc_offset_minutes هو -60 في الرأس الأخضر. |
viewport |
النوع:
LatLngBounds optionalإطار العرض المفضّل عند عرض هذا المكان على خريطة |
websiteURI |
النوع:
string optionalالموقع الإلكتروني الموثوق لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري |
|
النوع:
OpeningHours optional |
|
النوع:
boolean optional |
الطُرق | |
|---|---|
fetchFields |
fetchFields(options)المَعلمات:
|
|
getNextOpeningTime([date])المَعلمات:
تحسب هذه السمة التاريخ الذي يمثّل قيمة OpeningHoursTime التالية. تعرض هذه السمة القيمة "غير محدّد" إذا كانت البيانات غير كافية لاحتساب النتيجة، أو إذا كان هذا المكان غير صالح للعمل. |
|
isOpen([date])المَعلمات:
قيمة العائد:
Promise<boolean optional>تحقَّق ممّا إذا كان المكان مفتوحًا في التاريخ والوقت المحدّدَين. يتم عرض undefined إذا كانت البيانات المعروفة للموقع الجغرافي غير كافية لاحتساب هذه القيمة، مثلاً إذا كانت ساعات العمل غير مسجّلة. |
toJSON |
toJSON()المَعلمات: بدون
القيمة المعروضة:
Object عنصر JSON يتضمّن جميع خصائص "المكان" المطلوبة. |
PlaceOptions interface
google.maps.places.PlaceOptions
interface
خيارات لإنشاء "مكان"
الخصائص | |
|---|---|
id |
النوع:
stringالمعرّف الفريد للمكان. |
requestedLanguage optional |
النوع:
string optionalمعرّف اللغة التي يجب عرض التفاصيل بها اطّلِع على قائمة اللغات المتاحة. |
requestedRegion optional |
النوع:
string optionalرمز المنطقة التي يقيم فيها المستخدم ويمكن أن يؤثر ذلك في الصور التي قد يتم عرضها، وربما في أمور أخرى. يقبل رمز المنطقة قيمة 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معرّف الموارد المنتظم (URI) لمزوّد بيانات المكان |
فئة 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) للملف الشخصي للمؤلف لهذه النتيجة. |
فئة ConnectorAggregation
google.maps.places.ConnectorAggregation
صف
معلومات شحن المركبات الكهربائية، يتم تجميعها حسب الوصلات من النوع نفسه ومعدّل الشحن نفسه
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {ConnectorAggregation} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
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").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
connectorAggregations |
النوع:
Array<ConnectorAggregation>قائمة بعمليات تجميع لوصلات شحن المركبات الكهربائية التي تحتوي على وصلات من النوع نفسه ومعدّل الشحن نفسه |
connectorCount |
النوع:
numberعدد الموصلات في هذه المحطة بما أنّ بعض المنافذ يمكن أن تحتوي على موصلات متعددة ولكن يمكنها شحن سيارة واحدة فقط في كل مرة، قد يكون عدد الموصلات أكبر من إجمالي عدد السيارات التي يمكن شحنها في الوقت نفسه. |
ثوابت EVConnectorType
google.maps.places.EVConnectorType
الثوابت
أنواع وصلات شحن المركبات الكهربائية
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {EVConnectorType} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
CCS_COMBO_1 |
نظام الشحن المجمّع (تيار متردد وتيار مباشر) استنادًا إلى موصل SAE Type-1 J-1772. |
CCS_COMBO_2 |
نظام الشحن المجمّع (تيار متردد وتيار مباشر) استنادًا إلى موصّل Mennekes من النوع 2 |
CHADEMO |
موصّل من نوع CHAdeMO |
J1772 |
موصّل من النوع 1 وفقًا لمعيار J1772 |
NACS |
نظام الشحن في أمريكا الشمالية (NACS)، وهو نظام موحّد وفقًا لمعيار SAE J3400 |
OTHER |
أنواع الموصلات الأخرى |
TESLA |
الموصل العام لـ TESLA هذا هو معيار NACS في أمريكا الشمالية، ولكن يمكن أن يكون معيارًا آخر في أجزاء أخرى من العالم (مثل 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 interface
google.maps.places.EVSearchOptions
interface
خيارات ذات صلة بالمركبات الكهربائية يمكن تحديدها لطلب البحث عن مكان
الخصائص | |
|---|---|
connectorTypes optional |
النوع:
Array<EVConnectorType> optionalقائمة بأنواع وصلات المركبات الكهربائية المفضّلة تتم فلترة الأماكن التي لا تتوافق مع أي من أنواع أدوات الربط المُدرَجة. |
minimumChargingRateKw optional |
النوع:
number optionalالحدّ الأدنى لمعدّل الشحن المطلوب بالكيلوواط يتم استبعاد الأماكن التي تقل فيها نسبة الشحن عن النسبة المحدّدة. |
FetchFieldsRequest interface
google.maps.places.FetchFieldsRequest
interface
خيارات لجلب حقول "المكان".
الخصائص | |
|---|---|
fields |
النوع:
Array<string>قائمة الحقول المطلوب استردادها |
فئة FuelOptions
google.maps.places.FuelOptions
صف
أحدث المعلومات حول خيارات الوقود في محطة وقود ويتم تعديل هذه المعلومات بانتظام.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {FuelOptions} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
fuelPrices |
قائمة بأسعار الوقود لكل نوع من أنواع الوقود المتوفرة في هذه المحطة، مع إدخال واحد لكل نوع من أنواع الوقود |
فئة FuelPrice
google.maps.places.FuelPrice
صف
تقدّم هذه السمة معلومات عن سعر الوقود لنوع معيّن من الوقود.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {FuelPrice} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
price |
النوع:
Money optionalتمثّل هذه السمة سعر الوقود. |
type |
النوع:
FuelType optionalتمثّل هذه السمة نوع الوقود. |
updateTime |
النوع:
Date optionalيشير هذا العنصر إلى وقت آخر تعديل لسعر الوقود. |
ثوابت FuelType
google.maps.places.FuelType
الثوابت
أنواع الوقود
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {FuelType} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
BIO_DIESEL |
الديزل الحيوي |
DIESEL |
وقود الديزل |
DIESEL_PLUS |
وقود الديزل |
E100 |
E 100 |
E80 |
E 80. |
E85 |
E 85 |
LPG |
غاز البترول المُسال |
METHANE |
الميثان |
MIDGRADE |
متوسط |
PREMIUM |
Premium |
REGULAR_UNLEADED |
عادي غير رصاص. |
SP100 |
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 |
ديزل الشاحنات |
فئة GoogleMapsLinks
google.maps.places.GoogleMapsLinks
صف
روابط لتنفيذ إجراءات مختلفة على "خرائط Google"
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {GoogleMapsLinks} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
directionsURI |
النوع:
string optionalرابط لعرض الاتجاهات إلى المكان على "خرائط Google" يتم ملء الرابط بموقع الوجهة فقط ويستخدم وضع السفر التلقائي DRIVE. |
photosURI |
النوع:
string optionalرابط لعرض صور المكان على "خرائط Google" |
placeURI |
النوع:
string optionalرابط لعرض المكان على "خرائط Google" |
reviewsURI |
النوع:
string optionalرابط لعرض المراجعات الخاصة بالمكان على "خرائط Google" |
writeAReviewURI |
النوع:
string optionalرابط لكتابة مراجعة عن المكان على "خرائط Google" |
فئة الأموال
google.maps.places.Money
صف
تمثّل هذه السمة مبلغًا ماليًا مع نوع العملة.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Money} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
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").
اطّلِع على المكتبات في 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 class
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 class
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>نص الإحالة الذي سيتم عرضه لهذه الصورة |
flagContentURI |
النوع:
string optionalرابط يمكن للمستخدم من خلاله الإبلاغ عن مشكلة في الصورة |
googleMapsURI |
النوع:
string optionalرابط لعرض الصورة على "خرائط Google" |
heightPx |
النوع:
numberتمثّل هذه السمة ارتفاع الصورة بالبكسل. |
widthPx |
النوع:
numberتمثّل هذه السمة عرض الصورة بالبكسل. |
الطُرق | |
|---|---|
getURI |
getURI([options])المَعلمات:
قيمة العائد:
stringتعرض هذه السمة عنوان URL للصورة يتوافق مع الخيارات المحدّدة. |
فئة PlusCode
google.maps.places.PlusCode
صف
رمز Plus Codes للمكان لمزيد من المعلومات، يُرجى الانتقال إلى https://plus.codes/.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlusCode} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
compoundCode |
النوع:
string optionalرمز Plus Code يتضمّن مساحة تبلغ 1/8000 من الدرجة في 1/8000 من الدرجة، حيث يتم حذف الأحرف الأربعة الأولى (رمز المنطقة) واستبدالها بوصف للموقع الجغرافي. على سبيل المثال، "9G8F+5W زيورخ، سويسرا". |
globalCode |
النوع:
string optionalرمز موقع مفتوح يمثّل مساحة تبلغ 1/8000 من الدرجة في 1/8000 من الدرجة على سبيل المثال، "8FVC9G8F+5W". |
فئة PostalAddress
google.maps.places.PostalAddress
صف
تمثّل عنوانًا بريديًا (مثلاً، لخدمة بريدية لتوصيل السلع). ملاحظة: تستخدم JavaScript API السمة PostalAddress لإنشاء عناصر تمثّل البيانات التي تعرضها خدمة الويب.
تنفّذ هذه الفئة
PostalAddressLiteral.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PostalAddress} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
addressLines |
النوع:
Array<string>أسطر عناوين غير منظَّمة تصف المستويات الأدنى من العنوان |
administrativeArea |
النوع:
string optionalأعلى تقسيم فرعي إداري يُستخدم للعناوين البريدية في بلد أو منطقة |
languageCode |
النوع:
string optionalتمثّل هذه السمة رمز اللغة المستخدَمة في محتوى هذا العنوان وفق المعيار BCP-47. أمثلة: "zh-Hant" أو "ja" أو "ja-Latn" أو "en". |
locality |
النوع:
string optionalتشير هذه السمة بشكل عام إلى جزء المدينة/البلدة من العنوان. |
organization |
النوع:
string optionalتمثّل هذه السمة اسم المؤسسة في العنوان. |
postalCode |
النوع:
string optionalالرمز البريدي للعنوان |
recipients |
النوع:
Array<string>المستلِم في العنوان |
regionCode |
النوع:
stringرمز CLDR للمنطقة الذي يمثّل البلد/المنطقة التي يقع فيها العنوان مثال: "CH" لسويسرا. لمزيد من التفاصيل، يُرجى الانتقال إلى https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. |
sortingCode |
النوع:
string optionalرمز التصنيف الخاص بالعنوان |
sublocality |
النوع:
string optionalالمنطقة المحلية الفرعية للعنوان، مثل الأحياء أو المناطق الإدارية أو الدوائر |
PostalAddressLiteral interface
google.maps.places.PostalAddressLiteral
interface
بيانات لإنشاء PostalAddress
الخصائص | |
|---|---|
regionCode |
النوع:
stringيمكنك الاطّلاع على PostalAddress.regionCode. |
addressLines optional |
النوع:
Iterable<string> optionalيمكنك الاطّلاع على PostalAddress.addressLines. |
administrativeArea optional |
النوع:
string optionalيمكنك الاطّلاع على PostalAddress.administrativeArea. |
languageCode optional |
النوع:
string optionalيمكنك الاطّلاع على PostalAddress.languageCode. |
locality optional |
النوع:
string optionalيمكنك الاطّلاع على PostalAddress.locality. |
organization optional |
النوع:
string optionalيمكنك الاطّلاع على PostalAddress.organization. |
postalCode optional |
النوع:
string optionalيمكنك الاطّلاع على PostalAddress.postalCode. |
recipients optional |
النوع:
Iterable<string> optionalيمكنك الاطّلاع على PostalAddress.recipients. |
sortingCode optional |
النوع:
string optionalيمكنك الاطّلاع على PostalAddress.sortingCode. |
sublocality optional |
النوع:
string optionalيمكنك الاطّلاع على PostalAddress.sublocality. |
ثوابت PriceLevel
google.maps.places.PriceLevel
الثوابت
تمثّل هذه السمة مستوى السعر لمكان.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PriceLevel} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
EXPENSIVE |
|
FREE |
|
INEXPENSIVE |
|
MODERATE |
|
VERY_EXPENSIVE |
|
PriceRange class
google.maps.places.PriceRange
صف
نطاق الأسعار المرتبط بمكان. يمكن عدم ضبط endPrice، ما يشير إلى نطاق بدون حدّ أعلى (مثل "أكثر من 100 دولار أمريكي").
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PriceRange} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
endPrice |
النوع:
Money optionalتمثّل هذه السمة الحدّ الأعلى لنطاق الأسعار (شاملةً). يجب أن يكون السعر أقل من هذا المبلغ. |
startPrice |
النوع:
Moneyتمثّل هذه السمة الحد الأدنى لنطاق السعر (شاملةً). يجب أن يكون السعر مساويًا لهذا المبلغ أو أعلى منه. |
مراجعة الصف
google.maps.places.Review
صف
معلومات عن مراجعة مكان
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Review} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
authorAttribution |
النوع:
AuthorAttribution optionalالمراجع |
flagContentURI |
النوع:
string optionalرابط يمكن للمستخدم من خلاله الإبلاغ عن مشكلة في المراجعة |
googleMapsURI |
النوع:
string optionalرابط لعرض المراجعة على "خرائط Google" |
originalText |
النوع:
string optionalنص المراجعة بلغته الأصلية |
originalTextLanguageCode |
النوع:
string optionalرمز لغة IETF يشير إلى اللغة الأصلية للمراجعة. |
publishTime |
النوع:
Date optional |
rating |
النوع:
number optionalتمثّل هذه السمة تقييم المراجعة، وهو رقم يتراوح بين 1.0 و5.0 (بما يشمل هذين الرقمَين). |
relativePublishTimeDescription |
النوع:
string optionalسلسلة من الوقت الحديث المنسَّق، تعبّر عن وقت المراجعة بالنسبة إلى الوقت الحالي بتنسيق مناسب للغة والبلد على سبيل المثال، `"قبل شهر"'. |
text |
النوع:
string optionalتمثّل هذه السمة النص المترجَم للمراجعة. |
textLanguageCode |
النوع:
string optionalرمز لغة IETF يشير إلى اللغة المترجَمة للمراجعة. |
SearchByTextRequest interface
google.maps.places.SearchByTextRequest
interface
واجهة الطلب الخاصة بـ Place.searchByText
الخصائص | |
|---|---|
evSearchOptions optional |
النوع:
EVSearchOptions optionalخيارات ذات صلة بالمركبات الكهربائية يمكن تحديدها لطلب البحث عن مكان |
fields optional |
النوع:
Array<string> optionalمطلوب عند استخدام هذا الطلب مع Place.searchByText. الحقول التي سيتم تضمينها في الرد، والتي سيتم تحصيل رسوم مقابلها في حال إدخال ['*']، سيتم عرض جميع الحقول المتاحة وسيتم تحصيل رسوم مقابلها (لا يُنصح بهذا الإجراء في عمليات النشر في مرحلة الإنتاج). يمكنك طلب أي سمة في الفئة Place كحقل. |
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.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").
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
DISTANCE |
ترتيب النتائج حسب المسافة |
RELEVANCE |
ترتيب النتائج حسب مدى صلتها بموضوع البحث |
SearchNearbyRequest interface
google.maps.places.SearchNearbyRequest
interface
واجهة الطلب الخاصة بـ Place.searchNearby لمزيد من المعلومات حول الطلب، يُرجى الاطّلاع على مرجع Places API.
الخصائص | |
|---|---|
locationRestriction |
النوع:
Circle|CircleLiteralالمنطقة التي سيتم البحث فيها، ويتم تحديدها كدائرة لها مركز ونصف قطر لا يتم عرض نتائج خارج الموقع الجغرافي المحدّد. |
excludedPrimaryTypes optional |
النوع:
Array<string> optionalأنواع الأماكن الأساسية المستبعَدة اطّلِع على القائمة الكاملة بالأنواع المتوافقة. يمكن أن يكون للمكان نوع أساسي واحد فقط. يمكن تحديد ما يصل إلى 50 نوعًا. إذا حدّدت النوع نفسه في كل من قائمتَي included وexcluded، سيتم عرض الخطأ INVALID_ARGUMENT. |
excludedTypes optional |
النوع:
Array<string> optionalأنواع الأماكن المستبعَدة اطّلِع على القائمة الكاملة بالأنواع المتوافقة. يمكن أن يكون للمكان العديد من أنواع الأماكن المختلفة. يمكن تحديد ما يصل إلى 50 نوعًا. إذا حدّدت النوع نفسه في كل من قائمتَي included وexcluded، سيتم عرض الخطأ INVALID_ARGUMENT. |
fields optional |
النوع:
Array<string> optionalمطلوب عند استخدام هذا الطلب مع Place.searchNearby. الحقول التي سيتم تضمينها في الرد، والتي سيتم تحصيل رسوم مقابلها في حال إدخال ['*']، سيتم عرض جميع الحقول المتاحة وسيتم تحصيل رسوم مقابلها (لا يُنصح بهذا الإجراء في عمليات النشر في مرحلة الإنتاج). يمكنك طلب أي سمة في الفئة Place كحقل. |
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تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. للاطّلاع على القيم المقبولة والقيمة التلقائية، يُرجى الرجوع إلى مرجع Places API. |
rankPreference optional |
النوع:
SearchNearbyRankPreference optionalالقيمة التلقائية:
SearchNearbyRankPreference.POPULARITYكيفية ترتيب النتائج في الردّ |
region optional |
النوع:
string optionalرمز Unicode للبلد/المنطقة (CLDR) الخاص بالموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بالمنطقة، إذا كان متاحًا. يمكن أن تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري. لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. يُرجى العِلم أنّ رموز المناطق المكوّنة من 3 أرقام غير متاحة حاليًا. |
SearchNearbyRankPreference constants
google.maps.places.SearchNearbyRankPreference
الثوابت
تعداد RankPreference لفئة SearchNearbyRequest.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {SearchNearbyRankPreference} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
DISTANCE |
ترتيب النتائج حسب المسافة |
POPULARITY |
ترتيب النتائج حسب مدى رواجها |