Places Service (deprecated)

PlacesService class

class google.maps.places.PlacesService
library "places"

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

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

واجهة FindPlaceFromPhoneNumberRequest

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

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

واجهة FindPlaceFromQueryRequest

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

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

واجهة PlaceSearchRequest

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

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

واجهة TextSearchRequest

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

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

ثوابت RankBy

ثوابت google.maps.places.RankBy
مكتبة "places"

خيارات الترتيب لطلب PlaceSearchRequest

const {RankBy} = await google.maps.importLibrary("places");
DISTANCE لترتيب نتائج الأماكن حسب المسافة من الموقع الجغرافي
PROMINENCE يتم ترتيب نتائج الأماكن حسب مدى بروزها.

LocationBias typedef

typedef google.maps.places.LocationBias

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

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

LocationRestriction typedef

typedef google.maps.places.LocationRestriction

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

LatLngBounds|LatLngBoundsLiteral

ثوابت PlacesServiceStatus

ثوابت google.maps.places.PlacesServiceStatus
مكتبة "places"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع PlacesServiceStatusString.

const {PlacesServiceStatus} = await google.maps.importLibrary("places");
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()
المَعلمات: لا تتوفّر أي مَعلمات
القيمة المعروضة: void
لجلب الصفحة التالية من النتائج يستخدم دالّة رد الاتصال نفسها التي تم توفيرها لطلب البحث الأول.

PlaceResult interface

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

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

PlaceAspectRating

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

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

BusinessStatus constants

ثوابت google.maps.places.BusinessStatus
مكتبة "places"

حالة النشاط التجاري للمكان يُرجى مراجعة مستندات خدمة الويب للحصول على مزيد من المعلومات.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع BusinessStatusString.

const {BusinessStatus} = await google.maps.importLibrary("places");
CLOSED_PERMANENTLY المؤسسة مغلقة نهائيًا. يُرجى مراجعة مستندات خدمة الويب للحصول على مزيد من المعلومات.
CLOSED_TEMPORARILY المؤسسة مغلقة مؤقتًا. يُرجى مراجعة مستندات خدمة الويب للحصول على مزيد من المعلومات.
FUTURE_OPENING سيتم افتتاح المؤسسة في المستقبل. يُرجى مراجعة مستندات خدمة الويب للحصول على مزيد من المعلومات.
OPERATIONAL المؤسسة قيد التشغيل، وليس بالضرورة أن تكون مفتوحة الآن. يُرجى مراجعة مستندات خدمة الويب للحصول على مزيد من المعلومات.

واجهة PlaceGeometry

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

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

واجهة PlaceOpeningHours

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

تحدّد معلومات عن ساعات العمل في مكان معيّن.
open_now
اختياري
النوع: boolean optional
ما إذا كان المكان مفتوحًا في الوقت الحالي
periods
اختياري
النوع: Array<PlaceOpeningHoursPeriod> optional
فترات العمل لكل يوم من أيام الأسبوع، بدءًا من الأحد، بالترتيب الزمني ولا يتم تضمين الأيام التي لا يكون فيها المكان مفتوحًا. تتوفّر هذه الميزة فقط مع PlacesService.getDetails.
weekday_text
اختياري
النوع: 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
اختياري
النوع: 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
اختياري
النوع: 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
رمز Plus Code يمثّل منطقة تبلغ مساحتها 1/8000 من الدرجة في 1/8000 من الدرجة. مثلاً: "8FVC9G8F+5W"
compound_code
اختياري
النوع: 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
اختياري
النوع: number optional
الحد الأقصى لارتفاع الصورة المعروضة بالبكسل
maxWidth
اختياري
النوع: 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
اختياري
النوع: Array<PlaceAspectRating> optional
تمثّل هذه السمة الجوانب التي تم تقييمها في المراجعة. التقييمات على مقياس من 0 إلى 3
author_url
اختياري
النوع: string optional
عنوان URL لملف المراجع الشخصي ستكون هذه القيمة undefined عندما لا يكون الملف الشخصي للمراجع متاحًا.
rating
اختياري
النوع: number optional
تمثّل هذه السمة تقييم هذه المراجعة، وهو رقم يتراوح بين 1.0 و5.0 (ضمنًا).