Places Service

فئة PlacesService

google.maps.places.PlacesService صف

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

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

الشركة المصنِّعة
PlacesService	PlacesService(attrContainer) المَعلمات:  attrContainer:  HTMLDivElement|Map تنشئ هذه الدالة مثيلاً جديدًا من PlacesService يعرض بيانات تحديد المصدر في الحاوية المحدّدة.

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

PlaceDetailsRequest

google.maps.places.PlaceDetailsRequest interface

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

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

FindPlaceFromPhoneNumberRequest interface

google.maps.places.FindPlaceFromPhoneNumberRequest interface

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

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

FindPlaceFromQueryRequest interface

google.maps.places.FindPlaceFromQueryRequest interface

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

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

PlaceSearchRequest interface

google.maps.places.PlaceSearchRequest interface

طلب بحث عن مكان سيتم إرساله إلى 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	تم إيقافها نهائيًا: يُرجى استخدام keyword بدلاً منها. النوع:  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 interface

طلب بحث نصي سيتم إرساله إلى 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، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز 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 interface

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

الخصائص
hasNextPage	النوع:  boolean تشير إلى ما إذا كانت تتوفّر نتائج إضافية. true عندما تكون هناك صفحة نتائج إضافية

الطُرق
nextPage	nextPage() المَعلمات:  بدون قيمة العائد:  void يجلب الصفحة التالية من النتائج. يستخدم دالة رد الاتصال نفسها التي تم تقديمها لطلب البحث الأول.

واجهة PlaceResult

google.maps.places.PlaceResult interface

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

الخصائص
address_components optional	النوع:  Array<GeocoderAddressComponent> optional مجموعة مكوّنات العنوان الخاص بالموقع الجغرافي لهذا المكان متوفّر فقط مع PlacesService.getDetails.
adr_address optional	النوع:  string optional تمثيل عنوان "المكان" بتنسيق adr المصغّر متوفّر فقط مع 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	متوقّفة نهائيًا: تم إيقاف permanently_closed نهائيًا اعتبارًا من مايو 2020، وسيتم إيقافها في مايو 2021. استخدِم PlaceResult.business_status بدلاً من ذلك لأنّ permanently_closed لا يميّز بين حالات الإغلاق المؤقت والدائم. النوع:  boolean optional علامة تشير إلى ما إذا كان المكان مغلقًا، سواء بشكل دائم أو مؤقت إذا كان المكان يعمل، أو إذا لم تتوفّر أي بيانات، لن يظهر العلم في الردّ.
photos optional	النوع:  Array<PlacePhoto> optional صور لهذا المكان ستحتوي المجموعة على ما يصل إلى عشرة عناصر من النوع PlacePhoto.
place_id optional	النوع:  string optional تمثّل هذه السمة معرّفًا فريدًا للمكان.
plus_code optional	النوع:  PlacePlusCode optional تحدّد هذه السمة رموز Open Location Codes أو رموز 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	متوقّفة نهائيًا: تم إيقاف utc_offset نهائيًا اعتبارًا من تشرين الثاني (نوفمبر) 2019. يمكنك استخدام PlaceResult.utc_offset_minutes كبديل. راجِع https://goo.gle/js-open-now النوع:  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 PlaceAspectRating

google.maps.places.PlaceAspectRating interface

تم إيقافها نهائيًا: لم تعُد هذه الواجهة مستخدَمة.

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

الخصائص
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").
اطّلِع على المكتبات في Maps JavaScript API.

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

واجهة PlaceGeometry

google.maps.places.PlaceGeometry interface

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

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

PlaceOpeningHours واجهة

google.maps.places.PlaceOpeningHours interface

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

الخصائص
open_now optional	متوقّفة نهائيًا: تم إيقاف open_now نهائيًا اعتبارًا من تشرين الثاني (نوفمبر) 2019. استخدِم الطريقة PlaceOpeningHours.isOpen من نتيجة PlacesService.getDetails بدلاً من ذلك. راجِع https://goo.gle/js-open-now النوع:  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 interface

google.maps.places.PlaceOpeningHoursPeriod interface

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

الخصائص
open	النوع:  PlaceOpeningHoursTime تمثّل هذه السمة وقت بدء العمل في المكان.
close optional	النوع:  PlaceOpeningHoursTime optional تمثّل هذه السمة موعد إغلاق المكان.

PlaceOpeningHoursTime interface

google.maps.places.PlaceOpeningHoursTime interface

تحدّد هذه السمة وقت فتح مكان أو إغلاقه.

الخصائص
day	النوع:  number أيام الأسبوع، كرقم في النطاق [0, 6]، بدءًا من يوم الأحد. على سبيل المثال، 2 تعني الثلاثاء.
hours	النوع:  number تمثّل هذه السمة ساعات PlaceOpeningHoursTime.time كرقم ضمن النطاق [0, 23]، وسيتم عرضها في المنطقة الزمنية للمكان.
minutes	النوع:  number تمثّل هذه السمة دقائق PlaceOpeningHoursTime.time كرقم في النطاق [0, 59]. سيتم عرض هذه القيمة في المنطقة الزمنية للمكان.
time	النوع:  string الوقت من اليوم بتنسيق "hhmm" على مدار 24 ساعة تتراوح القيم بين ["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 interface

تحدّد هذه السمة رموز Open Location Codes أو رموز 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 interface

تمثّل هذه السمة عنصر صورة لمكان.

الخصائص
height	النوع:  number تمثّل هذه السمة ارتفاع الصورة بالبكسل.
html_attributions	النوع:  Array<string> نص الإحالة الذي سيتم عرضه لهذه الصورة
width	النوع:  number تمثّل هذه السمة عرض الصورة بالبكسل.

الطُرق
getUrl	getUrl([opts]) المَعلمات:  opts:  PhotoOptions optional قيمة العائد:  string تعرض هذه السمة عنوان URL للصورة يتوافق مع الخيارات المحدّدة.

واجهة PhotoOptions

google.maps.places.PhotoOptions interface

تحدّد هذه السمة خيارات طلب الصور.

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

PlaceReview interface

google.maps.places.PlaceReview interface

تمثّل هذه السمة مراجعة واحدة لمكان.

الخصائص
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 (بما يشمل هذين الرقمَين).