إشعار الأمان: نما إلى علمنا بمشكلة أمنية قد تؤثر في المواقع الإلكترونية التي تستخدم مكتبات معيّنة تابعة لجهات خارجية (بما في ذلك polyfill.io). وقد تؤدي هذه المشكلة في بعض الأحيان إلى إعادة توجيه الزائرين بعيدًا عن الموقع الإلكتروني المقصود بدون معرفة مالك الموقع أو إذنه. وفي السابق، كان يتضمّن العديد من نماذج JavaScript تعريف النص البرمجي polyfill.io. تمت إزالة هذا المحتوى من نماذجنا. إذا كنت قد استخدمت نماذج JavaScript التي تحتوي على هذا التعريف، ننصحك بإزالة التعريف.

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

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` قيمة الإرجاع: لا شيء استرداد قائمة من الأماكن بناءً على رقم الهاتف في معظم الحالات، يجب أن يكون هناك عنصر واحد فقط في قائمة النتائج، ولكن إذا كان الطلب غامضًا، فقد يتم عرض أكثر من نتيجة واحدة. إنّ `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` المسافة من الموقع الجغرافي المحدّد للبحث عن الأماكن بالأمتار. الحد الأقصى المسموح به للقيمة هو 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 ("نطاق المستوى الأعلى"). تتطابق معظم رموز 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، يجب تحديد المركز والنطاق الجغرافي.

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

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

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

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

واجهة PlaceResult

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

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

أماكن إقامة
`address_components optional`	النوع: `Array<GeocoderAddressComponent> optional` مجموعة مكونات العنوان للموقع الجغرافي لهذا المكان. تتوفّر هذه الميزة فقط مع `PlacesService.getDetails`.
`adr_address optional`	النوع: `string optional` تمثيل عنوان المكان في تنسيق DKIM. تتوفّر هذه الميزة فقط مع `PlacesService.getDetails`.
`aspects optional`	النوع: `Array<PlaceAspectRating> optional` تستند الجوانب التي تم تقييمها في هذا المكان إلى مراجعات المستخدمين في Google وZaga. يتم وضع التقييمات على مقياس من 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)، وبالتالي سيصبح `utc_offset` `660`. بالنسبة إلى المناطق الزمنية وراء التوقيت العالمي المنسَّق، تكون الإزاحة سالبة. على سبيل المثال، `utc_offset` هو `-60` للرأس الأخضر. تتوفّر هذه الميزة فقط مع `PlacesService.getDetails`.
`utc_offset_minutes optional`	النوع: `number optional` معادلة التوقيت العالمي المنسَّق (UTC) للمنطقة الزمنية الحالية للمكان، بالدقائق. على سبيل المثال، توقيت سيدني بأستراليا يسبق التوقيت الصيفي بـ 11 ساعة بالتوقيت العالمي المنسق (UTC)، وبالتالي سيصبح `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 ثابت

الحالة التشغيلية للمكان، إذا كان نشاطًا تجاريًا، يتم عرضها في نتيجة المكان (تشير إلى ما إذا كان المكان قيد التشغيل أو مغلقًا إما مؤقتًا أو نهائيًا). عليك تحديد هذه القيم حسب القيمة، أو اسم الثابت (مثال: '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

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

أماكن إقامة
`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 كبديل لعناوين الشوارع في الأماكن التي لا توجد فيها (حيث لا تكون المباني مرقمة أو لا يتم تسمية الشوارع).

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

أماكن إقامة

global_code

النوع: string

رمز زائد مع 1/8000 من الدرجة الأولى بمقدار 1/8000 درجة من مساحة درجة. مثلاً: "8FVC9G8F+5W"

compound_code optional

النوع: string optional

رمز زائد يتضمّن 1/8,000 درجة بمقدار 1/8,000 من مساحة درجة حيث يتم إسقاط الأحرف الأربعة الأولى (رمز المنطقة) واستبدالها بوصف المنطقة المحلية. مثلاً: "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

أماكن إقامة