Places Service

فئة PlacesService

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

تحتوي على طرق ذات صلة بالبحث عن أماكن واسترداد تفاصيل حول مكان ما.

يمكنك الوصول من خلال الاتصال على الرقم const {PlacesService} = await google.maps.importLibrary("places"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

PlacesService
PlacesService(attrContainer)
المَعلمات: 
تنشئ مثيلاً جديدًا من PlacesService يعرض الإحالات في الحاوية المحدّدة.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
المَعلمات: 
قيمة الإرجاع: لا شيء
استرداد قائمة من الأماكن بناءً على رقم الهاتف في معظم الحالات، يجب أن يكون هناك عنصر واحد فقط في قائمة النتائج، ولكن إذا كان الطلب غامضًا، فقد يتم عرض أكثر من نتيجة واحدة. إنّ PlaceResult التي تم تمريرها إلى معاودة الاتصال هي مجموعات فرعية من PlaceResult كاملة. يمكن لتطبيقك الحصول على PlaceResult أكثر تفصيلاً لكل مكان من خلال الاتصال على PlacesService.getDetails وإرسال PlaceResult.place_id للمكان المطلوب.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
المَعلمات: 
قيمة الإرجاع: لا شيء
لاسترداد قائمة من الأماكن استنادًا إلى سلسلة طلب بحث في معظم الحالات، يجب أن يكون هناك عنصر واحد فقط في قائمة النتائج، ولكن إذا كان الطلب غامضًا، فقد يتم عرض أكثر من نتيجة واحدة. إنّ PlaceResult التي تم تمريرها إلى معاودة الاتصال هي مجموعات فرعية من PlaceResult كاملة. يمكن لتطبيقك الحصول على PlaceResult أكثر تفصيلاً لكل مكان من خلال الاتصال على PlacesService.getDetails وإرسال PlaceResult.place_id للمكان المطلوب.
getDetails
getDetails(request, callback)
المَعلمات: 
قيمة الإرجاع: لا شيء
استرداد تفاصيل حول المكان المحدّد من خلال placeId المحدّد.
nearbySearch
nearbySearch(request, callback)
المَعلمات: 
قيمة الإرجاع: لا شيء
يسترد قائمة بالأماكن بالقرب من موقع معين، استنادًا إلى الكلمة الرئيسية أو النوع. يجب دائمًا تحديد الموقع الجغرافي، إما عن طريق تمرير المَعلمتَين LatLngBounds أو location وradius. تُعدّ PlaceResult التي تم تمريرها إلى معاودة الاتصال مجموعات فرعية من PlaceResult الكاملة. يمكن لتطبيقك الحصول على PlaceResult أكثر تفصيلاً لكل مكان عن طريق إرسال طلب تفاصيل المكان عن طريق إرسال PlaceResult.place_id للمكان المطلوب. يمكن استخدام الكائن PlaceSearchPagination لاسترجاع صفحات إضافية من النتائج (قيمة فارغة إذا كانت هذه هي الصفحة الأخيرة من النتائج أو إذا كانت هناك صفحة واحدة فقط من النتائج).
textSearch
textSearch(request, callback)
المَعلمات: 
قيمة الإرجاع: لا شيء
استرداد قائمة بالأماكن استنادًا إلى سلسلة طلب بحث (على سبيل المثال، "بيتزا في دبي" أو "متاجر أحذية بالقرب من أوتاوا"). مَعلمات الموقع الجغرافي اختيارية، فعندما يتم تحديد الموقع الجغرافي، تكون النتائج منحازة فقط نحو النتائج القريبة بدلاً من أن تقتصر على الأماكن داخل المنطقة. استخدِم textSearch عندما تريد البحث عن أماكن باستخدام سلسلة عشوائية، وفي الحالات التي قد لا تريد فيها أن تقتصر نتائج البحث على موقع جغرافي معيّن. يمكن استخدام الكائن PlaceSearchPagination لاسترجاع صفحات إضافية من النتائج (قيمة فارغة إذا كانت هذه هي الصفحة الأخيرة من النتائج أو إذا كانت هناك صفحة واحدة فقط من النتائج).

واجهة PlaceDetailsRequest

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

سيتم إرسال طلب بحث عن تفاصيل المكان إلى PlacesService.

placeId
النوع:  string
رقم تعريف المكان الذي تُطلب تفاصيل عنه.
fields optional
النوع:  Array<string> optional
الحقول التي سيتم تضمينها في ردّ التفاصيل، والتي سيتم تحصيل رسومها. في حال عدم تحديد أي حقول أو تمرير ['ALL']، سيتم عرض جميع الحقول المتاحة وتحصيل الرسوم بشأنها (لا يُنصَح بهذا الإجراء لعمليات نشر الإنتاج). للحصول على قائمة بالحقول، يُرجى الاطّلاع على PlaceResult. يمكن تحديد الحقول المتداخلة باستخدام مسارات النقاط (مثل "geometry.location").
language optional
النوع:  string optional
تمثّل هذه السمة معرّف اللغة للّغة التي يجب عرض التفاصيل بها. اطّلِع على قائمة اللغات المتاحة.
region optional
النوع:  string optional
رمز منطقة منطقة المستخدم. ويمكن أن يؤثر ذلك في الصور التي يمكن عرضها وربما في أشياء أخرى. يقبل رمز المنطقة قيمة مكوَّنة من حرفين ccTLD ("نطاق المستوى الأعلى"). تتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD) في المملكة المتحدة هو "uk" (.co.uk) في حين أنّ رمز ISO 3166-1 هو "gb" (من الناحية التقنية لكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
sessionToken optional
النوع:  AutocompleteSessionToken optional
مرجع فريد يُستخدَم لتجميع طلب التفاصيل مع جلسة إكمال تلقائي.

واجهة FindPlaceFromPhoneNumberRequest

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

مكان العثور على مكان من طلب البحث النصي لإرساله إلى PlacesService.findPlaceFromPhoneNumber.

fields
النوع:  Array<string>
الحقول التي سيتم تضمينها في الرد، والتي سيتم تحصيل رسومها. في حال اجتياز ['ALL']، سيتم عرض جميع الحقول المتاحة وتحصيل الرسوم مقابلها (لا يُنصَح بهذا الإجراء لعمليات نشر الإنتاج). للحصول على قائمة بالحقول، يُرجى الاطّلاع على PlaceResult. يمكن تحديد الحقول المتداخلة باستخدام مسارات النقاط (مثل "geometry.location").
phoneNumber
النوع:  string
رقم هاتف المكان المطلوب البحث عنه يجب أن يكون التنسيق E.164.
language optional
النوع:  string optional
تمثّل هذه السمة معرِّف اللغة للّغة التي يجب عرض الأسماء والعناوين بها، متى أمكن. اطّلِع على قائمة اللغات المتاحة.
locationBias optional
النوع:  LocationBias optional
التحيز المستخدم عند البحث عن المكان. وستكون النتيجة منحازة، على سبيل المثال لا الحصر، إلى العنصر LocationBias المحدّد.

واجهة FindPlaceFromQueryRequest

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

مكان العثور على مكان من طلب البحث النصي لإرساله إلى PlacesService.findPlaceFromQuery.

fields
النوع:  Array<string>
الحقول التي سيتم تضمينها في الرد، والتي سيتم تحصيل رسومها. في حال اجتياز ['ALL']، سيتم عرض جميع الحقول المتاحة وتحصيل الرسوم مقابلها (لا يُنصَح بهذا الإجراء لعمليات نشر الإنتاج). للحصول على قائمة بالحقول، يُرجى الاطّلاع على PlaceResult. يمكن تحديد الحقول المتداخلة باستخدام مسارات النقاط (مثل "geometry.location").
query
النوع:  string
استعلام الطلب. على سبيل المثال، اسم المكان أو عنوانه.
language optional
النوع:  string optional
تمثّل هذه السمة معرِّف اللغة للّغة التي يجب عرض الأسماء والعناوين بها، متى أمكن. اطّلِع على قائمة اللغات المتاحة.
locationBias optional
النوع:  LocationBias optional
التحيز المستخدم عند البحث عن المكان. وستكون النتيجة منحازة، على سبيل المثال لا الحصر، إلى العنصر LocationBias المحدّد.

واجهة PlaceSearchRequest

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

طلب بحث عن مكان سيتم إرساله إلى PlacesService.

bounds optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
الحدود التي يمكن البحث عن الأماكن من خلالها. سيتم تجاهل كل من location وradius في حال ضبط bounds.
keyword optional
النوع:  string optional
مصطلح تتم مطابقته مع كل الحقول المتاحة، بما في ذلك على سبيل المثال لا الحصر الاسم والنوع والعنوان، بالإضافة إلى مراجعات العملاء والمحتوى الآخر التابع لجهات خارجية.
language optional
النوع:  string optional
تمثّل هذه السمة معرِّف اللغة للّغة التي يجب عرض الأسماء والعناوين بها، متى أمكن. اطّلِع على قائمة اللغات المتاحة.
location optional
النوع:  LatLng|LatLngLiteral optional
الموقع الجغرافي الذي تريد البحث عن "الأماكن" حوله
maxPriceLevel optional
النوع:  number optional
لحصر النتائج في تلك الأماكن عند مستوى السعر المحدّد أو أدنى تتراوح القيم الصالحة بين 0 (الأكثر تكلفة) إلى 4 (الأكثر تكلفة)، بشكل شامل. ويجب أن تكون القيمة أكبر من أو تساوي minPrice ، إذا تم تحديدها.
minPriceLevel optional
النوع:  number optional
لحصر النتائج بالأماكن التي تتمّ بمستوى السعر المحدّد أو أعلى فقط. تتراوح القيم الصالحة بين 0 (الأكثر تكلفة) إلى 4 (الأكثر تكلفة)، بشكل شامل. ويجب أن تكون القيمة أقل من أو تساوي maxPrice، إذا تم تحديدها.
name optional
النوع:  string optional
هذا الرمز مكافئ للرمز keyword. يتم دمج القيم في هذا الحقل مع القيم في الحقل keyword، ويتم تمريرها كجزء من سلسلة البحث نفسها.
openNow optional
النوع:  boolean optional
يحصر النتائج بالأماكن المفتوحة في الوقت الحالي فقط.
radius optional
النوع:  number optional
المسافة من الموقع الجغرافي المحدّد للبحث عن الأماكن بالأمتار. الحد الأقصى المسموح به للقيمة هو 50,000.
rankBy optional
النوع:  RankBy optional
الخيار التلقائي: RankBy.PROMINENCE
تحدِّد هذه السياسة طريقة الترتيب التي سيتم استخدامها عند عرض النتائج. تجدر الإشارة إلى أنّه عند ضبط rankBy على DISTANCE، عليك تحديد location ولكن لا يمكنك تحديد radius أو bounds.
type optional
النوع:  string optional
يبحث عن أماكن من النوع المحدّد. تتم ترجمة النوع إلى اللغة المحلية للموقع الجغرافي المستهدَف للطلب واستخدامه كسلسلة طلب بحث. إذا تم أيضًا توفير طلب بحث، يتم ربطه بسلسلة النوع المترجَم. يتم إسقاط نتائج من نوع مختلف من الردّ. استخدم هذا الحقل لإجراء عمليات بحث فئوي بشكل مستقل عن اللغة والمنطقة. تتوفّر الأنواع الصالحة هنا.

واجهة TextSearchRequest

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

طلب بحث نصي ليتم إرساله إلى "PlacesService"

bounds optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
الحدود المستخدمة لانحياز النتائج عند البحث عن الأماكن (اختياري) سيتم تجاهل كل من location وradius في حال ضبط bounds. لن تقتصر النتائج على العناصر داخل هذه الحدود، ولكن ستحقّق النتائج الواردة فيها ترتيبًا أعلى.
language optional
النوع:  string optional
تمثّل هذه السمة معرِّف اللغة للّغة التي يجب عرض الأسماء والعناوين بها، متى أمكن. اطّلِع على قائمة اللغات المتاحة.
location optional
النوع:  LatLng|LatLngLiteral optional
يشير ذلك المصطلح إلى مركز المنطقة المستخدَم لانحياز النتائج عند البحث عن "الأماكن".
query optional
النوع:  string optional
عبارة طلب البحث للطلب. على سبيل المثال، اسم مكان ("برج إيفل")، أو فئة متبوعة باسم الموقع الجغرافي ("البيتزا في دبي") أو اسم مكان متبوعًا بأداة تمييز الموقع الجغرافي ("ستاربكس في سيدني").
radius optional
النوع:  number optional
نصف قطر المنطقة المستخدم لتحيز النتائج عند البحث عن الأماكن، بالمتر.
region optional
النوع:  string optional
يشير ذلك المصطلح إلى رمز منطقة يتم فيه انحياز النتائج. يقبل رمز المنطقة قيمة مكوَّنة من حرفين ccTLD ("نطاق المستوى الأعلى"). تتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD) في المملكة المتحدة هو "uk" (.co.uk) في حين أنّ رمز ISO 3166-1 هو "gb" (من الناحية التقنية لكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
type optional
النوع:  string optional
يبحث عن أماكن من النوع المحدّد. تتم ترجمة النوع إلى اللغة المحلية للموقع الجغرافي المستهدَف للطلب واستخدامه كسلسلة طلب بحث. إذا تم أيضًا توفير طلب بحث، يتم ربطه بسلسلة النوع المترجَم. يتم إسقاط نتائج من نوع مختلف من الردّ. استخدم هذا الحقل لإجراء عمليات بحث فئوي بشكل مستقل عن اللغة والمنطقة. تتوفّر الأنواع الصالحة هنا.

القيم الثابتة RankBy

google.maps.places.RankBy ثابت

خيارات الترتيب لـ PlaceSearchRequest.

يمكنك الوصول من خلال الاتصال على الرقم const {RankBy} = await google.maps.importLibrary("places"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

DISTANCE يرتّب نتائج الأماكن حسب المسافة من الموقع الجغرافي.
PROMINENCE تضع الترتيبات النتائج حسب بروزها.

LocationBias typedef

google.maps.places.LocationBias typedef

يمثل LocationBias حدًا مبدئيًا أو تلميحًا لاستخدامه عند البحث عن "الأماكن". قد تأتي النتائج من خارج المنطقة المحددة. لاستخدام عنوان IP للمستخدِم الحالي كانحياز، يمكن تحديد السلسلة "IP_BIAS". ملاحظة: إذا كنت تستخدم Circle، يجب تحديد المركز والنطاق الجغرافي.

LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

يمثل LocationRestriction حدًا صارمة لاستخدامه عند البحث عن "الأماكن".

LatLngBounds|LatLngBoundsLiteral

الثوابت PlacesServiceStatus

google.maps.places.PlacesServiceStatus ثابت

تعرض هذه السمة الحالة PlacesService عند اكتمال عمليات البحث. يُرجى تحديد هذه القيم حسب القيمة، أو باستخدام اسم الثابت. على سبيل المثال، 'OK' أو google.maps.places.PlacesServiceStatus.OK.

يمكنك الوصول من خلال الاتصال على الرقم const {PlacesServiceStatus} = await google.maps.importLibrary("places"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

INVALID_REQUEST هذا الطلب غير صالح.
NOT_FOUND لم يتم العثور على المكان المشار إليه.
OK ويحتوي الرد على نتيجة صالحة.
OVER_QUERY_LIMIT تجاوز التطبيق حصة الطلبات المخصصة له.
REQUEST_DENIED لا يُسمح للتطبيق باستخدام PlacesService.
UNKNOWN_ERROR تعذَّرت معالجة طلب "PlacesService" بسبب خطأ في الخادم. قد ينجح الطلب إذا أعدت المحاولة.
ZERO_RESULTS لم يتم العثور على نتائج لهذا الطلب.

واجهة PlaceSearchPagination

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

كائن يُستخدم لجلب صفحات إضافية من نتائج الأماكن.

hasNextPage
النوع:  boolean
تشير هذه السمة إلى ما إذا كانت هناك نتائج أخرى متوفّرة. true عند توفُّر صفحة نتائج إضافية.
nextPage
nextPage()
المَعلمات: لا شيء
قيمة الإرجاع: لا شيء
يجلب الصفحة التالية من النتائج. تستخدم وظيفة معاودة الاتصال نفسها التي تم توفيرها لطلب البحث الأول.

واجهة PlaceResult

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

تحدِّد هذه السمة معلومات عن مكان معيّن.

address_components optional
النوع:  Array<GeocoderAddressComponent> optional
مجموعة مكونات العنوان للموقع الجغرافي لهذا المكان. تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
adr_address optional
النوع:  string optional
تمثيل عنوان المكان في تنسيق DKIM. تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
aspects optional
النوع:  Array<PlaceAspectRating> optional
تستند الجوانب التي تم تقييمها في هذا المكان إلى مراجعات المستخدمين في Google وZaga. يتم وضع التقييمات على مقياس من 0 إلى 30.
business_status optional
النوع:  BusinessStatus optional
علامة تشير إلى الحالة التشغيلية للمكان، إذا كان نشاطًا تجاريًا (تشير إلى ما إذا كان المكان قيد التشغيل أو مغلقًا إما مؤقتًا أو نهائيًا). وإذا لم تتوفر أي بيانات، لا تظهر العلامة في الردود على البحث أو التفاصيل.
formatted_address optional
النوع:  string optional
عنوان المكان الكامل.
formatted_phone_number optional
النوع:  string optional
رقم هاتف المكان، منسَّق وفقًا للاصطلاح الإقليمي الخاص بالرقم. تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
geometry optional
النوع:  PlaceGeometry optional
المعلومات المتعلّقة بهندسة المكان
html_attributions optional
النوع:  Array<string> optional
نص الإحالة الذي سيتم عرضه لنتيجة المكان هذه. يتم دائمًا عرض html_attributions المتاحة بغضّ النظر عن قيمة fields المطلوبة، ويجب عرضها.
icon optional
النوع:  string optional
عنوان URL لمورد صورة يمكن استخدامه لتمثيل فئة هذا المكان.
icon_background_color optional
النوع:  string optional
لون الخلفية للاستخدام مع رمز أحد الأماكن. يمكنك أيضًا الاطّلاع على PlaceResult.icon_mask_base_uri.
icon_mask_base_uri optional
النوع:  string optional
عنوان URL مقتطَع إلى قناع رمز. يمكنك الوصول إلى أنواع الرموز المختلفة من خلال إلحاق امتداد ملف بالنهاية (مثل .svg أو .png).
international_phone_number optional
النوع:  string optional
تمثّل هذه السمة رقم هاتف المكان بالتنسيق الدولي. يتضمن التنسيق الدولي رمز البلد، ويبدأ بعلامة الجمع (+). تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
name optional
النوع:  string optional
اسم المكان. ملاحظة: في حالة إدخال المستخدم لـ "الأماكن"، يكون هذا هو النص الأولي، كما كتبه المستخدم. يُرجى توخي الحذر عند استخدام هذه البيانات، حيث قد يحاول المستخدمون الضارون استخدامها كمتجه لهجمات حقن الرموز (راجع http://en.wikipedia.org/wiki/Code_injection).
opening_hours optional
النوع:  PlaceOpeningHours optional
تحدد الحالات التي يفتح فيها المكان أو يغلقه.
permanently_closed optional
النوع:  boolean optional
علامة تشير إلى ما إذا كان المكان مغلقًا، إما بشكل دائم أو مؤقت. إذا كان المكان يعمل أو إذا لم تتوفّر أي بيانات، لن تظهر العلامة في الردّ.
photos optional
النوع:  Array<PlacePhoto> optional
صور لهذا المكان ستحتوي المجموعة على ما يصل إلى عشرة عناصر PlacePhoto.
place_id optional
النوع:  string optional
معرّف فريد للمكان.
plus_code optional
النوع:  PlacePlusCode optional
تحدِّد هذه السمة رموز المواقع الجغرافية المفتوحة أو "رموز المواقع المفتوحة" للمكان.
price_level optional
النوع:  number optional
مستوى سعر المكان، على مقياس من 0 إلى 4. يتم تفسير مستويات السعر على النحو التالي:
  • 0: مجاني
  • 1: غير مكلفة
  • 2: معتدل
  • 3: باهظ الثمن
  • 4: باهظ الثمن
rating optional
النوع:  number optional
تقييم يتراوح من 1.0 إلى 5.0 استنادًا إلى مراجعات المستخدمين لهذا المكان.
reviews optional
النوع:  Array<PlaceReview> optional
قائمة بالمراجعات حول هذا المكان تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
types optional
النوع:  Array<string> optional
مصفوفة من أنواع المكان (على سبيل المثال، ["political", "locality"] أو ["restaurant", "establishment"]).
url optional
النوع:  string optional
عنوان URL لصفحة Google الرسمية لهذا المكان هذه هي الصفحة التي تملكها Google وتحتوي على أفضل المعلومات المتوفرة حول المكان. تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
user_ratings_total optional
النوع:  number optional
عدد تقييمات المستخدمين التي ساهمت في PlaceResult.rating لهذا المكان.
utc_offset optional
النوع:  number optional
معادلة التوقيت العالمي المنسَّق (UTC) للمنطقة الزمنية الحالية للمكان، بالدقائق. على سبيل المثال، توقيت سيدني بأستراليا يسبق التوقيت الصيفي بـ 11 ساعة بالتوقيت العالمي المنسق (UTC)، وبالتالي سيصبح utc_offset 660. بالنسبة إلى المناطق الزمنية وراء التوقيت العالمي المنسَّق، تكون الإزاحة سالبة. على سبيل المثال، utc_offset هو -60 للرأس الأخضر. تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
utc_offset_minutes optional
النوع:  number optional
معادلة التوقيت العالمي المنسَّق (UTC) للمنطقة الزمنية الحالية للمكان، بالدقائق. على سبيل المثال، توقيت سيدني بأستراليا يسبق التوقيت الصيفي بـ 11 ساعة بالتوقيت العالمي المنسق (UTC)، وبالتالي سيصبح utc_offset_minutes 660. بالنسبة إلى المناطق الزمنية وراء التوقيت العالمي المنسَّق، تكون الإزاحة سالبة. على سبيل المثال، utc_offset_minutes هو -60 للرأس الأخضر. تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
vicinity optional
النوع:  string optional
العنوان المبسّط للمكان، بما في ذلك اسم الشارع ورقم الشارع والمنطقة المحلية، ولكن ليس الإقليم/الولاية أو الرمز البريدي أو البلد. على سبيل المثال، قيمة المنطقة القريبة لمكتب Google في مدينة الرياض بأستراليا هي "48 Pirrama Road, Pyrmont". تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
website optional
النوع:  string optional
الموقع الإلكتروني الموثوق به لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري تتوفّر هذه الميزة فقط مع PlacesService.getDetails.

واجهة PlaceAspectRating

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

تحدد المعلومات حول جانب من المكان راجعه المستخدمون.

rating
النوع:  number
تمثّل هذه السمة تقييم هذا الجانب. وفي المراجعات الفردية، يكون هذا العدد عددًا صحيحًا يتراوح بين 0 و3. وفيما يتعلق بالتقييمات المجمّعة لمكان ما، يكون هذا العدد عددًا صحيحًا يتراوح بين 0 و30.
type
النوع:  string
نوع العرض على سبيل المثال، "food" أو "decor" أو "service" أو "overall".

ثابت BusinessStatus

google.maps.places.BusinessStatus ثابت

الحالة التشغيلية للمكان، إذا كان نشاطًا تجاريًا، يتم عرضها في نتيجة المكان (تشير إلى ما إذا كان المكان قيد التشغيل أو مغلقًا إما مؤقتًا أو نهائيًا). عليك تحديد هذه القيم حسب القيمة، أو اسم الثابت (مثال: 'OPERATIONAL' أو google.maps.places.BusinessStatus.OPERATIONAL).

يمكنك الوصول من خلال الاتصال على الرقم const {BusinessStatus} = await google.maps.importLibrary("places"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

CLOSED_PERMANENTLY النشاط التجاري مغلق نهائيًا.
CLOSED_TEMPORARILY النشاط التجاري مغلق مؤقتًا.
OPERATIONAL يعمل النشاط التجاري بشكل طبيعي.

واجهة PlaceGeometry

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

تحدد المعلومات حول الأشكال الهندسية للمكان.

location optional
النوع:  LatLng optional
تمثّل هذه السمة موضع المكان.
viewport optional
النوع:  LatLngBounds optional
إطار العرض المفضل عند عرض هذا "المكان" على الخريطة. ستظهر هذه السمة null إذا لم يكن إطار العرض المفضّل للمكان معروفًا. تتوفّر هذه الميزة فقط مع PlacesService.getDetails.

واجهة PlaceOpeningHours

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

تحدد المعلومات حول ساعات عمل المكان.

open_now optional
النوع:  boolean optional
ما إذا كان المكان مفتوحًا في الوقت الحالي
periods optional
النوع:  Array<PlaceOpeningHoursPeriod> optional
فترات الفتح التي تغطي كل يوم من الأسبوع، بدءًا من الأحد، بترتيب زمني لا يتم تضمين الأيام التي لا يكون فيها المكان مفتوحًا. تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
weekday_text optional
النوع:  Array<string> optional
مصفوفة من سبع سلاسل تمثل ساعات العمل المنسقة لكل يوم من أيام الأسبوع. ستقوم خدمة الأماكن بتنسيق ساعات العمل وأقلمتها بشكل مناسب للغة الحالية. يعتمد ترتيب العناصر في هذه الصفيفة على اللغة. تبدأ بعض اللغات الأسبوع يوم الاثنين بينما تبدأ لغات أخرى يوم الأحد. تتوفّر هذه الميزة فقط مع PlacesService.getDetails. قد تعرض المكالمات الأخرى صفيفًا فارغًا.
isOpen
isOpen([date])
المَعلمات: 
  • dateDate optional
قيمة الإرجاع:  boolean|undefined
تحقّق مما إذا كان المكان مفتوحًا الآن (في حال عدم انقضاء تاريخ) أو في التاريخ المحدَّد. إذا كان هذا المكان لا يتضمّن PlaceResult.utc_offset_minutes أو PlaceOpeningHours.periods، يتم عرض undefined (تتوفّر PlaceOpeningHours.periods فقط عبر PlacesService.getDetails). ولا تأخذ هذه الطريقة ساعات العمل الاستثنائية، مثل ساعات العطلات.

واجهة PlaceOpeningHoursPeriod

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

تحدد المعلومات المنظمة حول ساعات العمل في مكان ما. ملاحظة: إذا كان المكان مفتوحًا دائمًا، لن يظهر القسم close في الرد. يمكن للعملاء الاعتماد على عبارة "المفتوح دائمًا" كفترة open تحتوي على day بالقيمة 0 وtime بالقيمة "0000"، بدون close.

open
النوع:  PlaceOpeningHoursTime
تمثّل هذه السمة وقت فتح المكان.
close optional
النوع:  PlaceOpeningHoursTime optional
تمثّل هذه السمة وقت إغلاق المكان.

واجهة PlaceOpeningHoursTime

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

تحدد الحالات التي يفتح فيها أحد الأماكن أو يغلقه.

day
النوع:  number
أيام الأسبوع، كرقم في نطاق [0، 6]، بدءًا من يوم الأحد. على سبيل المثال، تعني 2 يوم الثلاثاء.
hours
النوع:  number
ساعات عمل PlaceOpeningHoursTime.time كرقم، في نطاق [0، 23]. سيتم الإبلاغ عن ذلك حسب المنطقة الزمنية للمكان.
minutes
النوع:  number
دقائق PlaceOpeningHoursTime.time كرقم، في نطاق [0، 59]. وسيتم الإبلاغ عن ذلك في المنطقة الزمنية للمكان.
time
النوع:  string
الوقت من اليوم بتنسيق 24 ساعة "hhmm". تقع القيم في نطاق ["0000"، "2359"]. سيتم تسجيل الوقت وفقًا للمنطقة الزمنية للمكان.
nextDate optional
النوع:  number optional
الطابع الزمني (بالملّي ثانية منذ تاريخ بدء حساب الفترة، مناسب للاستخدام مع new Date()) الذي يمثّل موضع الورود التالي لـ PlaceOpeningHoursTime ويتم احتسابها من PlaceOpeningHoursTime.day في الأسبوع وPlaceOpeningHoursTime.time وPlaceResult.utc_offset_minutes. وإذا كانت قيمة PlaceResult.utc_offset_minutes هي undefined، ستكون قيمة nextDate هي undefined.

واجهة PlacePlusCode

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

تحدِّد هذه السمة رموز المواقع الجغرافية المفتوحة أو "رموز المواقع المفتوحة" لمكان معيّن. يمكن استخدام رموز Plus Codes كبديل لعناوين الشوارع في الأماكن التي لا توجد فيها (حيث لا تكون المباني مرقمة أو لا يتم تسمية الشوارع).

global_code
النوع:  string
رمز زائد مع 1/8000 من الدرجة الأولى بمقدار 1/8000 درجة من مساحة درجة. مثلاً: "8FVC9G8F+5W"
compound_code optional
النوع:  string optional
رمز زائد يتضمّن 1/8,000 درجة بمقدار 1/8,000 من مساحة درجة حيث يتم إسقاط الأحرف الأربعة الأولى (رمز المنطقة) واستبدالها بوصف المنطقة المحلية. مثلاً: "9G8F+5W Zurich, Switzerland" إذا لم تكن هناك منطقة محلية مناسبة يمكن العثور عليها لتقصير الرمز، فسيتم حذف هذا الحقل.

واجهة PlacePhoto

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

يمثل عنصر صورة لمكان.

height
النوع:  number
ارتفاع الصورة بالبكسل.
html_attributions
النوع:  Array<string>
سيتم عرض نص الإحالة لهذه الصورة.
width
النوع:  number
عرض الصورة بالبكسل.
getUrl
getUrl([opts])
المَعلمات: 
قيمة الإرجاع:  string
لعرض عنوان URL للصورة المقابل للخيارات المحدّدة.

واجهة PhotoOptions

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

تحديد خيارات طلب الصور.

maxHeight optional
النوع:  number optional
الحد الأقصى للارتفاع بالبكسل للصورة التي يتم عرضها.
maxWidth optional
النوع:  number optional
الحد الأقصى للعرض بالبكسل للصورة التي يتم عرضها.

واجهة PlaceReview

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

يمثل مراجعة واحدة لمكان.

author_name
النوع:  string
تمثّل هذه السمة اسم المُراجع.
language
النوع:  string
رمز لغة مجموعة مهندسي شبكة الإنترنت (IETF) يشير إلى اللغة المستخدَمة لكتابة هذه المراجعة تجدر الإشارة إلى أنّ هذا الرمز لا يتضمّن سوى علامة اللغة الرئيسية بدون أي علامة ثانوية تشير إلى البلد أو المنطقة. على سبيل المثال، يتمّ وضع علامة 'en' بدلاً من "en-AU" أو "en-UK" على جميع المراجعات باللغة الإنجليزية.
profile_photo_url
النوع:  string
تمثّل هذه السمة عنوان URL لصورة الملف الشخصي الخاصة بإعادة التحميل.
relative_time_description
النوع:  string
سلسلة من تنسيقات الوقت الأخيرة تعبّر عن وقت المراجعة مقارنةً بالوقت الحالي في نموذج مناسب للغة والبلد مثلاً: "a month ago"
text
النوع:  string
نص المراجعة.
time
النوع:  number
الطابع الزمني للمراجعة، ويتم التعبير عنه بالثواني منذ تاريخ بدء حساب الفترة.
aspects optional
النوع:  Array<PlaceAspectRating> optional
تمثّل هذه السمة الجوانب التي تم تقييمها من خلال المراجعة. التقييمات على مقياس من 0 إلى 3.
author_url optional
النوع:  string optional
تمثّل هذه السمة عنوان URL للملف الشخصي الخاص بالمراجع. سيكون هذا هو undefined عندما يكون الملف الشخصي للمُراجع غير متاح.
rating optional
النوع:  number optional
تمثّل هذه السمة تقييم هذه المراجعة، وهو رقم يتراوح من 1.0 إلى 5.0 (شاملاً).