Places Service

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة PlaceService

google.maps.places.PlacesService الصف الدراسي

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

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {PlacesService} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
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
المسافة من الموقع المحدد والتي يتم البحث داخلها عن الأماكن، بالأمتار. الحد الأقصى المسموح به للقيمة هو 50000.
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
للبحث عن أماكن من نوع معين. تتم ترجمة النوع إلى اللغة المحلية للموقع المستهدف للطلب واستخدامه كسلسلة طلب بحث. إذا تم أيضًا تقديم طلب بحث، يتم ربطه بسلسلة النوع المترجم. يتم إسقاط النتائج من نوع مختلف من الاستجابة. استخدم هذا الحقل لإجراء عمليات بحث فئوية مستقلة عن اللغة والمنطقة. وتتوفّر الأنواع الصالحة هنا.

ثواني الثوابت

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

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

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {RankBy} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
DISTANCE تضع التصنيفات النتائج بحسب المسافة من الموقع.
PROMINENCE تضع الترتيبات النتائج حسب بروزها.

LocationBias typedef

google.maps.places.LocationBias typedef

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

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

تقييد المواقع typedef

google.maps.places.LocationRestriction typedef

يمثل تقييد الموقع حدًا صارمًا للاستخدام عند البحث عن الأماكن.

LatLngBounds|LatLngBoundsLiteral

ثوابت PlaceServiceStatus

google.maps.places.PlacesServiceStatus ثوابت

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

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {PlacesServiceStatus} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
INVALID_REQUEST هذا الطلب غير صالح.
NOT_FOUND لم يتم العثور على المكان المشار إليه.
OK تحتوي الاستجابة على نتيجة صالحة.
OVER_QUERY_LIMIT تجاوز التطبيق حصة الطلبات.
REQUEST_DENIED لا يُسمح للتطبيق باستخدام PlacesService.
UNKNOWN_ERROR تعذرت معالجة الطلب PlacesService بسبب خطأ في الخادم. قد ينجح الطلب في حال إعادة المحاولة.
ZERO_RESULTS لم يتم العثور على أي نتائج لهذا الطلب.

واجهة PlaceSearchPagiting

واجهة 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
تمثيل عنوان المكان في adr microformat متاح فقط في 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
تحدد "رموز المواقع المفتوحة" أو "رموز المواقع المفتوحة" للمكان.
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_offset سيكون 660. بالنسبة إلى المناطق الزمنية وراء التوقيت العالمي المنسق (UTC)، تكون الإزاحة سالبة. على سبيل المثال، utc_offset هو -60 للرأس الأخضر. متاح فقط في PlacesService.getDetails.
utc_offset_minutes optional
النوع: number optional
الفرق من التوقيت العالمي المنسق (UTC) من المنطقة الزمنية الحالية للمكان بالدقائق. على سبيل المثال، توقيت سيدني الصيفي في أستراليا يسبق التوقيت الصيفي بـ 11 ساعة، وبالتالي فإن utc_offset_minutes سيكون 660. بالنسبة إلى المناطق الزمنية وراء التوقيت العالمي المنسق (UTC)، تكون الإزاحة سالبة. على سبيل المثال، 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).

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {BusinessStatus} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
CLOSED_PERMANENTLY النشاط التجاري مغلق نهائيًا.
CLOSED_TEMPORARILY النشاط التجاري مغلق مؤقتًا.
OPERATIONAL النشاط التجاري يعمل بشكل طبيعي.

واجهة GeoGeo الواجهة

واجهة 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
تمثّل هذه الخاصية وقت فتح المكان.
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
تمثل هذه الخاصية الوقت من اليوم بتنسيق "25 ساعة". تقع القيم في النطاق ["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

لتحديد "رموز المواقع المفتوحة" أو "رموز المواقع المفتوحة" لمكان ما. يمكن استخدام رموز المواقع المفتوحة كبديل لعناوين الشوارع في الأماكن التي لا توجد فيها (حيث لا تكون المباني مرقمة أو لا يتم تسمية الشوارع).
global_code
النوع: string
رمز علامة الجمع الذي يتضمّن درجة 1/8000 من الدرجة 1/8000 من مساحة الدرجة. مثلاً: "8FVC9G8F+5W"
compound_code optional
النوع: string optional
رمز علامة زائد بزاوية 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 (شامل).