Places Service

فئة PlacesService

google.maps.places.PlacesService class

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlacesService} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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) المكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو 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
عبارة طلب البحث. على سبيل المثال، اسم مكان (مثل "برج إيفل") أو فئة متبوعة باسم موقع جغرافي (مثل "بيتزا في القاهرة") أو اسم مكان متبوعًا بعنصر لإزالة الالتباس بشأن الموقع الجغرافي (مثل "Starbucks في القاهرة").
radius optional
النوع:  number optional
شعاع المنطقة المستخدَمة لتحديد النتائج عند البحث عن أماكن، بالكيلومترات
region optional
النوع:  string optional
رمز منطقة لتوجيه النتائج نحوها يقبل رمز المنطقة قيمة نطاق المستوى الأعلى لرموز البلدان (ccTLD) المكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو uk (.co.uk) بينما رمزه وفقًا لمعيار ISO 3166-1 هو gb (للجهة المعروفة رسميًا باسم "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
type optional
النوع:  string optional
البحث عن أماكن من النوع المحدّد تتم ترجمة النوع إلى اللغة المحلية للموقع الجغرافي المستهدَف للطلب ويتم استخدامه كسلسلة طلب بحث. في حال توفّر طلب بحث أيضًا، يتم تسلسله مع سلسلة النوع المترجَمة. ويتم حذف النتائج من نوع مختلف من الاستجابة. استخدِم هذا الحقل لإجراء عمليات بحث تصنيفية مستقلة عن اللغة والمنطقة. يمكنك الاطّلاع على الأنواع الصالحة هنا.

RankBy الثوابت

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

خيارات الترتيب لطلب البحث عن مكان

يمكنك الوصول إليه من خلال الاتصال بالرقم const {RankBy} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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
تمثيل عنوان المكان في تنسيق dr المصغر. لا يتوفّر إلا مع PlacesService.getDetails.
aspects optional
النوع:  Array<PlaceAspectRating> optional
الجوانب التي تم تقييمها في هذا "المكان"، استنادًا إلى مراجعات مستخدمي Google وZagat يتم التقييم باستخدام مقياس من 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
لتحديد رموز المواقع الجغرافية المفتوحة أو "رموز Plus Codes" للمكان
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
التوقيت المحلي للمكان مقارنةً بالتوقيت العالمي المنسق، بالكيلومترات على سبيل المثال، في سيدني، أستراليا، يكون التوقيت الصيفي قبل التوقيت العالمي المنسَّق بـ 11 ساعة، لذا سيكون utc_offset هو 660. بالنسبة إلى المناطق الزمنية التي تسبق التوقيت العالمي المنسق، يكون الفارق سلبيًا. على سبيل المثال، utc_offset هو -60 للرأس الأخضر. لا يتوفّر إلا مع PlacesService.getDetails.
utc_offset_minutes optional
النوع:  number optional
التوقيت المحلي للمكان مقارنةً بالتوقيت العالمي المنسق، بالكيلومترات على سبيل المثال، في سيدني، أستراليا، يكون التوقيت الصيفي قبل التوقيت العالمي المنسَّق بـ 11 ساعة، لذا سيكون 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 الثوابت

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {BusinessStatus} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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])
المَعلمات: 
  • date:  Date 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" لمكان معيّن. يمكن استخدام رموز Plus Codes كبديل لعناوين الشوارع في الأماكن التي لا تتوفّر فيها (حيث لا يتم ترقيم المباني أو تسمية الشوارع).
global_code
النوع:  string
رمز موقع مفتوح بمساحة 1/8000 من الدرجة في 1/8000 من الدرجة مثلاً: "8FVC9G8F+5W"
compound_code optional
النوع:  string optional
رمز Plus Code بمساحة 1/8000 من الدرجة إلى 1/8000 من الدرجة يتم فيها حذف الأحرف الأربعة الأولى (رمز المنطقة) واستبدالها بوصف للمنطقة مثلاً: "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 (بما في ذلك هذين الرقمَين)