سيتوفّر تصميم الخريطة الجديد قريبًا على "منصة خرائط Google". يتضمن هذا التحديث على تصميم الخريطة لوحة ألوان تلقائية جديدة وتحسينات على تجارب الخرائط وسهولة الاستخدام. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. للمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل الميزة في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد في "منصة خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Places Service

فئة PlaceService

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

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

الوصول من خلال الاتصال بـ const {PlacesService} = await google.maps.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

الشركة المصنِّعة
`PlacesService`	`PlacesService(attrContainer)` المعلّمات: `attrContainer`: `HTMLDivElement\|Map` لإنشاء مثيل جديد من `PlacesService` يعرض الإحالات في الحاوية المحددة.

الطُرق
`findPlaceFromPhoneNumber`	`findPlaceFromPhoneNumber(request, callback)` المعلّمات: `request`: `FindPlaceFromPhoneNumberRequest` `callback`: `function(Array<PlaceResult> optional, PlacesServiceStatus): void` قيمة الإرجاع: بدون لاسترداد قائمة الأماكن بناءً على رقم الهاتف. في معظم الحالات، يجب أن يكون هناك عنصر واحد فقط في قائمة النتائج، ولكن إذا كان الطلب غامضًا، فقد يتم عرض أكثر من نتيجة واحدة. `PlaceResult` التي يتم تمريرها إلى معاودة الاتصال هي مجموعات فرعية من `PlaceResult` كامل. يمكن لتطبيقك الحصول على `PlaceResult` أكثر تفصيلاً لكل مكان عن طريق الاتصال بـ `PlacesService.getDetails` وتمرير `PlaceResult.place_id` للمكان المطلوب.
`findPlaceFromQuery`	`findPlaceFromQuery(request, callback)` المعلّمات: `request`: `FindPlaceFromQueryRequest` `callback`: `function(Array<PlaceResult> optional, PlacesServiceStatus): void` قيمة الإرجاع: بدون لاسترداد قائمة الأماكن بناءً على سلسلة طلب بحث. في معظم الحالات، يجب أن يكون هناك عنصر واحد فقط في قائمة النتائج، ولكن إذا كان الطلب غامضًا، فقد يتم عرض أكثر من نتيجة واحدة. `PlaceResult` التي يتم تمريرها إلى معاودة الاتصال هي مجموعات فرعية من `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`. `PlaceResult` التي يتم تمريرها إلى معاودة الاتصال هي مجموعات فرعية من `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

طلب تفاصيل المكان لإرساله إلى 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`	متوقف: استخدِم `keyword` بدلاً من ذلك. النوع: `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.

الوصول من خلال الاتصال بـ const {RankBy} = await google.maps.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

الثوابت
`DISTANCE`	تضع التصنيفات النتائج بحسب المسافة من الموقع.
`PROMINENCE`	تضع الترتيبات النتائج حسب بروزها.

LocationBias typedef

google.maps.places.LocationBias typedef

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

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

google.maps.places.LocationRestriction typedef

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

LatLngBounds|LatLngBoundsLiteral

ثوابت PlaceServiceStatus

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

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

الوصول من خلال الاتصال بـ const {PlacesServiceStatus} = await google.maps.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`	متوقف: تم إيقاف `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` تحدد "رموز المواقع المفتوحة" أو "رموز المواقع المفتوحة" للمكان.
`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` الفرق من التوقيت العالمي المنسق (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).

الوصول من خلال الاتصال بـ const {BusinessStatus} = await google.maps.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`	متوقف: `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`). ولا تعتمد هذه الطريقة ساعات العمل الاستثنائية، مثل ساعات العمل خلال العطلات.

الطُرق

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` تمثل هذه الخاصية الوقت من اليوم بتنسيق "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"` إذا لم تكن هناك منطقة محلية مناسبة يمكن العثور عليها لتقصير الشفرة، فسيتم حذف هذا الحقل.

أماكن إقامة

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])` المعلّمات: `opts`: `PhotoOptions optional` قيمة الإرجاع: `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 (شامل).

Places Service

فئة PlaceService

الشركة المصنِّعة

الطُرق

PlaceDetailsRequest واجهة

أماكن إقامة

واجهة FindPlaceFromPhoneNumberRequest

أماكن إقامة

واجهة FindPlaceFromQueryRequest

أماكن إقامة

PlaceSearchRequest واجهة

أماكن إقامة

TextSearchRequest واجهة

أماكن إقامة

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

الثوابت

LocationBias typedef

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

ثوابت PlaceServiceStatus

الثوابت

واجهة PlaceSearchPagiting

أماكن إقامة

الطُرق

PlaceResult واجهة

أماكن إقامة

PlaceAspectRating واجهة

أماكن إقامة

BusinessStatus الثوابت

الثوابت

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

أماكن إقامة

واجهة PlaceOpeningHours

أماكن إقامة

الطُرق

واجهة PlaceOpeningHoursPeriod

أماكن إقامة

واجهة PlaceOpeningHoursTime

أماكن إقامة

واجهة PlacePlusCode

أماكن إقامة

واجهة PlacePhoto

أماكن إقامة

الطُرق

PhotoOptions واجهة

أماكن إقامة

PlaceReview واجهة

أماكن إقامة