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

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

Places Service

فئة PlacesService

google.maps.places.PlacesService class

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

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

الشركة المصنِّعة
`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) المكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو uk (`.co.uk`) بينما رمزه وفقًا لمعيار ISO 3166-1 هو gb (للجهة المعروفة باسم "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
`sessionToken optional`	النوع: `AutocompleteSessionToken optional` مرجع فريد يُستخدَم لتجميع طلب التفاصيل مع جلسة إكمال تلقائي.

FindPlaceFromPhoneNumberRequest واجهة

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

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

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

واجهة FindPlaceFromQueryRequest

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

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

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

واجهة PlaceSearchRequest

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

طلب بحث عن مكان لإرساله إلى PlacesService

أماكن إقامة
`bounds optional`	النوع: `LatLngBounds\|LatLngBoundsLiteral optional` الحدود التي يتم البحث ضمنها عن الأماكن سيتم تجاهل كل من `location` و`radius` في حال ضبط `bounds`.
`keyword optional`	النوع: `string optional` عبارة يتم مطابقتها مع جميع الحقول المتاحة، بما في ذلك على سبيل المثال لا الحصر، الاسم والنوع والعنوان، بالإضافة إلى مراجعات العملاء والمحتوى الآخر التابع لجهات خارجية.
`language optional`	النوع: `string optional` معرّف اللغة التي يجب عرض الأسماء والعناوين بها، إن أمكن اطّلِع على قائمة اللغات المتاحة.
`location optional`	النوع: `LatLng\|LatLngLiteral optional` الموقع الجغرافي الذي تريد البحث عن أماكن حوله
`maxPriceLevel optional`	النوع: `number optional` يحصر هذا الخيار ظهور النتائج على تلك الأماكن فقط بمستوى السعر المحدّد أو مستوى أدنى. تتراوح القيم الصالحة بين 0 (الأكثر تكلفة) و4 (الأكثر تكلفة) بشكل شامل. يجب أن تكون أكبر من أو تساوي `minPrice` ، في حال تحديدها.
`minPriceLevel optional`	النوع: `number optional` حصر النتائج بالأماكن التي توفّر مستوى السعر المحدّد أو أعلى تتراوح القيم الصالحة بين 0 (الأكثر تكلفة) و4 (الأكثر تكلفة) ضمنًا. يجب أن تكون القيمة أقل من أو تساوي `maxPrice`، في حال تحديدها.
`name optional`	متوقّف نهائيًا: استخدِم `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 واجهة

طلب بحث نصي يتم إرساله إلى 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) المكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
`DISTANCE`	ترتيب نتائج الأماكن حسب المسافة من الموقع الجغرافي
`PROMINENCE`	تُرتّب الترتيبات النتائج حسب أهميتها.

LocationBias typedef

google.maps.places.LocationBias typedef

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

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

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

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus الثوابت

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

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

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

الثوابت
`INVALID_REQUEST`	هذا الطلب غير صالح.
`NOT_FOUND`	لم يتم العثور على المكان المشار إليه.
`OK`	يحتوي الرد على نتيجة صالحة.
`OVER_QUERY_LIMIT`	تجاوز التطبيق حصته من الطلبات.
`REQUEST_DENIED`	لا يُسمح للتطبيق باستخدام `PlacesService`.
`UNKNOWN_ERROR`	تعذّرت معالجة طلب `PlacesService` بسبب خطأ في الخادم. قد ينجح الطلب إذا حاولت مرة أخرى.
`ZERO_RESULTS`	لم يتم العثور على أي نتيجة لهذا الطلب.

واجهة PlaceSearchPagination

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

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

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

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

واجهة PlaceResult

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

لتحديد معلومات عن مكان

أماكن إقامة
`address_components optional`	النوع: `Array<GeocoderAddressComponent> optional` مجموعة مكونات العنوان لموقع "المكان" هذا الجغرافي لا يتوفّر إلا مع `PlacesService.getDetails`.
`adr_address optional`	النوع: `string optional` تمثيل عنوان المكان في تنسيق dr المصغر. لا يتوفّر إلا مع `PlacesService.getDetails`.
`aspects optional`	النوع: `Array<PlaceAspectRating> optional` الجوانب التي تم تقييمها في هذا "المكان"، استنادًا إلى مراجعات مستخدمي Google وZagat يتم التقييم باستخدام مقياس من 0 إلى 30.
`business_status optional`	النوع: `BusinessStatus optional` علامة تشير إلى الحالة التشغيلية للمكان، إذا كان نشاطًا تجاريًا (تشير إلى ما إذا كان المكان قيد التشغيل أو مغلقًا إما مؤقتًا أو نهائيًا). إذا لم تتوفّر أي بيانات، لن تظهر العلامة في نتائج البحث أو الردود التفصيلية.
`formatted_address optional`	النوع: `string optional` تمثّل هذه السمة عنوان المكان الكامل.
`formatted_phone_number optional`	النوع: `string optional` رقم هاتف "المكان"، منسَّق وفقًا للاتفاقية الإقليمية للرقم. لا يتوفّر إلا مع `PlacesService.getDetails`.
`geometry optional`	النوع: `PlaceGeometry optional` المعلومات المتعلّقة بهندسة "المكان"
`html_attributions optional`	النوع: `Array<string> optional` نص الإحالة الذي سيتم عرضه لنتيجة "المكان" هذه يتم عرض `html_attributions` المتاحة دائمًا بغض النظر عن `fields` التي تمّ طلبها، ويجب عرضها.
`icon optional`	النوع: `string optional` عنوان URL لمصدر صورة يمكن استخدامه لتمثيل فئة هذا المكان
`icon_background_color optional`	النوع: `string optional` لون الخلفية لاستخدامه مع رمز المكان يمكنك الاطّلاع أيضًا على `PlaceResult.icon_mask_base_uri`.
`icon_mask_base_uri optional`	النوع: `string optional` عنوان URL تم اقتطاعه لقناع رمز. يمكنك الوصول إلى أنواع رموز مختلفة من خلال إلحاق امتداد ملف في النهاية (مثل `.svg` أو `.png`).
`international_phone_number optional`	النوع: `string optional` رقم هاتف المكان بالتنسيق الدولي يتضمّن التنسيق الدولي رمز البلد، ويتمّ وضع علامة الجمع (+) قبله. لا يتوفّر إلا مع `PlacesService.getDetails`.
`name optional`	النوع: `string optional` اسم المكان ملاحظة: في حال إدخال المستخدم لأماكن، يكون هذا هو النص الأوّلي كما كتبه المستخدم. يُرجى توخي الحذر عند استخدام هذه البيانات، لأنّ المستخدمين الضارّين قد يحاولون استخدامها كوسيط لهجمات إدخال الرموز البرمجية (راجِع http://en.wikipedia.org/wiki/Code_injection).
`opening_hours optional`	النوع: `PlaceOpeningHours optional` لتحديد وقت فتح المكان أو إغلاقه
`permanently_closed optional`	متوقّفة نهائيًا: تم إيقاف "`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` لتحديد رموز المواقع الجغرافية المفتوحة أو "رموز 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

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

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

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

BusinessStatus الثوابت

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {BusinessStatus} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

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

واجهة PlaceGeometry

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

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

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

PlaceOpeningHours

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

تحدد المعلومات حول ساعات عمل المكان.

أماكن إقامة
`open_now optional`	متوقفة نهائيًا: تم إيقاف `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` الوقت من اليوم بتنسيق 24 ساعة "hhmm". القيم ضمن النطاق [`"0000"`، `"2359"`]، وسيتم تسجيل الوقت في المنطقة الزمنية للمكان.
`nextDate optional`	النوع: `number optional` الطابع الزمني (بالمللي ثانية منذ البداية، وهو مناسب للاستخدام مع `new Date()`) الذي يمثّل الورود التالي لـ PlaceOpeningHoursTime ويتم احتسابها من `PlaceOpeningHoursTime.day` الأسبوع و`PlaceOpeningHoursTime.time` و`PlaceResult.utc_offset_minutes`. إذا كانت قيمة السمة `PlaceResult.utc_offset_minutes` هي `undefined`، ستكون قيمة الحقل `nextDate` هي `undefined`.

واجهة PlacePlusCode

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

تحدِّد هذه السمة رموز المواقع الجغرافية المفتوحة أو "رموز Plus Codes" لمكان معيّن. يمكن استخدام رموز Plus Codes كبديل لعناوين الشوارع في الأماكن التي لا تتوفّر فيها (حيث لا يتم ترقيم المباني أو تسمية الشوارع).

أماكن إقامة
`global_code`	النوع: `string` رمز موقع مفتوح بمساحة 1/8000 من الدرجة في 1/8000 من الدرجة مثلاً: `"8FVC9G8F+5W"`
`compound_code optional`	النوع: `string optional` رمز Plus Codes بمساحة 1/8000 من الدرجة إلى 1/8000 من الدرجة يتم فيها حذف الأحرف الأربعة الأولى (رمز المنطقة) واستبدالها بوصف للمنطقة مثلاً: `"9G8F+5W Zurich, Switzerland"` إذا لم يتم العثور على منطقة محلية مناسبة لتقصير الرمز، سيتم حذف هذا الحقل.

أماكن إقامة

global_code

النوع: string

رمز موقع مفتوح بمساحة 1/8000 من الدرجة في 1/8000 من الدرجة مثلاً: "8FVC9G8F+5W"

compound_code optional

النوع: string optional

رمز Plus Codes بمساحة 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

فئة PlacesService

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

الطُرق

واجهة PlaceDetailsRequest

أماكن إقامة

FindPlaceFromPhoneNumberRequest واجهة

أماكن إقامة

واجهة FindPlaceFromQueryRequest

أماكن إقامة

واجهة PlaceSearchRequest

أماكن إقامة

واجهة TextSearchRequest

أماكن إقامة

RankBy الثوابت

الثوابت

LocationBias typedef

LocationRestriction typedef

PlacesServiceStatus الثوابت

الثوابت

واجهة PlaceSearchPagination

أماكن إقامة

الطُرق

واجهة PlaceResult

أماكن إقامة

واجهة PlaceAspectRating

أماكن إقامة

BusinessStatus الثوابت

الثوابت

واجهة PlaceGeometry

أماكن إقامة

PlaceOpeningHours

أماكن إقامة

الطُرق

PlaceOpeningHoursPeriod واجهة

أماكن إقامة

PlaceOpeningHoursTime

أماكن إقامة

واجهة PlacePlusCode

أماكن إقامة

واجهة PlacePhoto

أماكن إقامة

الطُرق

واجهة PhotoOptions

أماكن إقامة

واجهة PlaceReview

أماكن إقامة