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

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

Place (beta)

مكان المكان

صف واحد (google.maps.places.Place)

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

الشركة المصنِّعة
`Place`	`Place(options)` المعلّمات: `options`: `PlaceOptions`

الطرق الثابتة
`findPlaceFromPhoneNumber`	ملاحظة: هذه الميزة متاحة فقط على v=القناة التجريبية. `findPlaceFromPhoneNumber(request)` المعلّمات: `request`: `FindPlaceFromPhoneNumberRequest` الطلب الذي يتضمّن رقم الهاتف والحقول المطلوبة قيمة العرض: `Promise<{places:Array<Place>}>` يبحث عن مكان استنادًا إلى رقم الهاتف المحدد. عرض صفيف بسبب حالات نادرة قد يشارك فيها عدة أماكن رقم هاتف
`findPlaceFromQuery`	ملاحظة: هذه الميزة متاحة فقط على v=القناة التجريبية. `findPlaceFromQuery(request)` المعلّمات: `request`: `FindPlaceFromQueryRequest` الطلب الذي يتضمّن طلب البحث النصي والحقول المطلوبة قيمة العرض: `Promise<{places:Array<Place>}>` يبحث عن مكان استنادًا إلى طلب البحث النصي المحدد. تعرض صفيفًا بسبب الحالات التي يكون فيها طلب البحث غامضًا قليلاً، ويتم عرض أكثر من مكان واحد. ولا تهدف هذه الطريقة إلى إجراء عمليات البحث التي يُتوقّع أن تكون فيها نتائج متعددة.

الطرق الثابتة

findPlaceFromPhoneNumber

findPlaceFromPhoneNumber(request)

المعلّمات:

request: FindPlaceFromPhoneNumberRequest الطلب الذي يتضمّن رقم الهاتف والحقول المطلوبة

قيمة العرض: Promise<{places:Array<Place>}>

يبحث عن مكان استنادًا إلى رقم الهاتف المحدد. عرض صفيف بسبب حالات نادرة قد يشارك فيها عدة أماكن رقم هاتف

findPlaceFromQuery

findPlaceFromQuery(request)

المعلّمات:

request: FindPlaceFromQueryRequest الطلب الذي يتضمّن طلب البحث النصي والحقول المطلوبة

قيمة العرض: Promise<{places:Array<Place>}>

يبحث عن مكان استنادًا إلى طلب البحث النصي المحدد. تعرض صفيفًا بسبب الحالات التي يكون فيها طلب البحث غامضًا قليلاً، ويتم عرض أكثر من مكان واحد. ولا تهدف هذه الطريقة إلى إجراء عمليات البحث التي يُتوقّع أن تكون فيها نتائج متعددة.

أماكن إقامة
`addressComponents`	النوع: `Array<AddressComponent> optional` مجموعة مكوّنات العنوان الخاصة بالموقع الجغرافي لهذا المكان عنصر فارغ إذا لم تكن هناك بيانات عنوان معروفة. `undefined` إذا لم يتم طلب بيانات العنوان من الخادم.
`adrFormatAddress`	النوع: `string optional` تمثيل عنوان المكان في تنسيق نمط ملف adr.
`attributions`	النوع: `Array<Attribution> optional` نص الإحالة الذي سيتم عرضه لنتيجة المكان هذه.
`businessStatus`	النوع: `BusinessStatus optional` الحالة التشغيلية للموقع الجغرافي. `null` إذا لم تكن هناك حالة معروفة. `undefined` إذا لم يتم تحميل بيانات الحالة من الخادم.
`displayName`	النوع: `string optional` الاسم المعروض للموقع الجغرافي. `null` إذا لم يكن هناك اسم. `undefined` إذا لم يتم تحميل بيانات الاسم من الخادم.
`formattedAddress`	النوع: `string optional` عنوان الموقع الجغرافي بالكامل
`googleMapsURI`	النوع: `string optional` عنوان URL لصفحة Google الرسمية لهذا المكان. هذه هي الصفحة التي تملكها Google وتحتوي على أفضل المعلومات المتاحة عن المكان.
`hasCurbsidePickup`	النوع: `boolean optional` ما إذا كان المكان تتوفّر فيه خدمة الإيصال إلى السيارة. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`hasDelivery`	النوع: `boolean optional` ما إذا كان المكان تتوفّر فيه خدمة التوصيل تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`hasDineIn`	النوع: `boolean optional` إمكانية تناول الطعام في المكان تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`hasTakeout`	النوع: `boolean optional` ما إذا كان المكان يحتوي على طعام سفري أم لا. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`hasWheelchairAccessibleEntrance`	النوع: `boolean optional` ما إذا كان المكان يحتوي على مدخل صالح للكراسي المتحركة تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`iconBackgroundColor`	النوع: `string optional` رمز لون HEX التلقائي لفئة المكان.
`id`	النوع: `string` معرّف المكان الفريد.
`internationalPhoneNumber`	النوع: `string optional` تمثّل هذه السمة رقم هاتف المكان بالتنسيق الدولي. ويحتوي التنسيق الدولي على رمز البلد، مسبوقًا بعلامة الجمع (+).
`isReservable`	النوع: `boolean optional` ما إذا كان المكان قابلاً للحجز. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`location`	النوع: `LatLng optional` تمثّل هذه السمة موضع المكان.
`nationalPhoneNumber`	النوع: `string optional` رقم هاتف المكان، منسَّق وفقًا للمؤتمر الإقليمي للرقم
`openingHours`	النوع: `OpeningHours optional`
`photos`	النوع: `Array<Photo> optional` صور لهذا المكان. ستتضمّن المجموعة ما يصل إلى عشرة عناصر `Photo`.
`plusCode`	النوع: `PlusCode optional`
`priceLevel`	النوع: `PriceLevel optional` مستوى سعر المكان. يمكن أن يعرض هذا الموقع أيًّا من القيم التالية `Free` `Inexpensive` `Moderate` `Expensive` `Very Expensive`
`rating`	النوع: `number optional` تقييم يتراوح من 1.0 إلى 5.0، استنادًا إلى مراجعات المستخدمين لهذا المكان.
`requestedLanguage`	النوع: `string optional` اللغة المطلوبة لهذا المكان
`requestedRegion`	النوع: `string optional` تمثّل هذه السمة المنطقة المطلوبة لهذا المكان.
`reviews`	النوع: `Array<Review> optional` قائمة بمراجعات لهذا المكان.
`servesBeer`	النوع: `boolean optional` مكان يقدّم البيرة تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`servesBreakfast`	النوع: `boolean optional` ما إذا كان المكان يقدّم وجبات الفطور. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`servesBrunch`	النوع: `boolean optional` ما إذا كان المكان يقدّم وجبات الإفطار المتأخر أم لا. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`servesDinner`	النوع: `boolean optional` ما إذا كان المكان يقدّم العشاء أم لا. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`servesLunch`	النوع: `boolean optional` ما إذا كان المكان يقدّم وجبات الغداء. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`servesVegetarianFood`	النوع: `boolean optional` ما إذا كان أحد الأماكن يقدّم مأكولات نباتية تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`servesWine`	النوع: `boolean optional` ما إذا كان المكان يقدّم النبيذ. تعرض "true" أو "false" إذا كانت القيمة معروفة. عرض "فارغ" إذا كانت القيمة غير معروفة. تعرض "غير محدّد" إذا لم يتم طلب هذا الحقل بعد.
`svgIconMaskURI`	النوع: `string optional` معرّف الموارد المنتظم (URI) إلى مورد قناع الصورة بتنسيق svg الذي يمكن استخدامه لتمثيل فئة مكان.
`types`	النوع: `Array<string> optional` مصفوفة من أنواع هذا المكان (على سبيل المثال، `["political", "locality"]` أو `["restaurant", "establishment"]`).
`userRatingCount`	النوع: `number optional` عدد تقييمات المستخدمين التي ساهمت في `Place.rating` لهذا المكان.
`utcOffsetMinutes`	النوع: `number optional` التوقيت بالدقائق حسب التوقيت العالمي المنسَّق (UTC) للمنطقة الزمنية الحالية للمكان على سبيل المثال، توقيت شرق النمسا الرسمي (GMT+10) في التوقيت الصيفي متقدم بنسبة 11 ساعة بالتوقيت العالمي المتفق عليه، وبالتالي سيكون `utc_offset_minutes` `660`. بالنسبة إلى المناطق الزمنية خلف التوقيت العالمي المنسق، تكون التعويض سالبة. على سبيل المثال، `utc_offset_minutes` هو `-60` لرأس المال الأخضر.
`viewport`	النوع: `LatLngBounds optional` إطار العرض المفضّل عند عرض هذا المكان على الخريطة
`websiteURI`	النوع: `string optional` الموقع الإلكتروني الموثوق به لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري.

الطُرق
`fetchFields`	ملاحظة: هذه الميزة متاحة فقط على v=القناة التجريبية. `fetchFields(options)` المعلّمات: `options`: `FetchFieldsRequest` قيمة العرض: `Promise<{place:Place}>`
`getNextOpeningTime`	ملاحظة: هذه الميزة متاحة فقط على v=القناة التجريبية. `getNextOpeningTime([date])` المعلّمات: `date`: `Date optional` قيمة العرض: `Promise<Date optional>` تحسب التاريخ الذي يمثّل ساعات العمل التالية. عرض غير معروف إذا كانت البيانات غير كافية لحساب النتيجة، أو هذا المكان لا يعمل.
`isOpen`	ملاحظة: هذه الميزة متاحة فقط على v=القناة التجريبية. `isOpen([date])` المعلّمات: `date`: `Date optional` الإعدادات التلقائية الآن. قيمة العرض: `Promise<boolean optional>` تحقّق مما إذا كان المكان مفتوحًا في تاريخ ووقت محدّد. يتم التعامل مع `undefined` إذا كانت البيانات المعروفة للموقع الجغرافي غير كافية لحساب ذلك، مثلاً إذا كانت ساعات العمل غير مسجَّلة.
`toJSON`	`toJSON()` المعلّمات: بدون قيمة العرض: `Object` لكائن JSON يتضمّن جميع خصائص المكان المطلوبة.

واجهة PlaceOptions

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

خيارات لبناء مكان.

أماكن إقامة
`id`	النوع: `string` معرّف المكان الفريد.
`requestedLanguage optional`	النوع: `string optional` معرّف اللغة الذي يجب عرض التفاصيل فيه. اطّلع على قائمة اللغات المتاحة.
`requestedRegion optional`	النوع: `string optional` رمز منطقة منطقة المستخدم. ويمكن أن يؤثّر ذلك في الصور التي قد يتم عرضها، وربما عناصر أخرى. يقبل رمز المنطقة قيمة تتألف من حرفين في ccTLD ("نطاق المستوى الأعلى"). وتتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، نطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD) في المملكة المتحدة هو "uk" (`.co.uk`)، بينما رمز ISO 3166-1 هو "gb" (من الناحية الفنية، بالنسبة إلى الكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").

فئةAddressPlugins

صف واحد (google.maps.places.AddressComponent)

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

أماكن إقامة
`longText`	النوع: `string optional` النص الكامل لمكوِّن العنوان.
`shortText`	النوع: `string optional` النص القصير والقصير للمكوّن في العنوان المحدد.
`types`	النوع: `Array<string>` مصفوفة من السلاسل تشير إلى نوع مكوّن العنوان هذا. يمكنك الاطّلاع على قائمة بالأنواع الصالحة هنا.

فئةالإحالة

صف واحد (google.maps.places.Attribution)

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

أماكن إقامة
`provider`	النوع: `string optional` نص الإحالة الذي سيتم عرضه لنتيجة المكان هذه.
`providerURI`	النوع: `string optional`

واجهة FetchFieldsRequest

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

خيارات جلب حقول المكان

أماكن إقامة
`fields`	النوع: `Array<string>` قائمة الحقول التي سيتم جلبها
`sessionToken optional`	النوع: `AutocompleteSessionToken optional` مرجع فريد يُستخدَم لتجميع طلب التفاصيل مع جلسة إكمال تلقائي.

ساعات العمل

صف واحد (google.maps.places.OpeningHours)

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

أماكن إقامة
`periods`	النوع: `Array<OpeningHoursPeriod>` فترات الافتتاح التي تغطي كل يوم من الأسبوع، بدءًا من الأحد، بترتيب زمني. ولا يتضمن الأيام التي لا يتم فيها فتح هذا المكان.
`weekdayDescriptions`	النوع: `Array<string>` مصفوفة من سبعة سلاسل تمثّل ساعات العمل المنسّقة لكل يوم من أيام الأسبوع. ستعمل خدمة "الأماكن" على تنسيق ساعات العمل وأقلمةها بشكلٍ مناسب للغة الحالية. ويعتمد ترتيب العناصر في هذه المصفوفة على اللغة. وبعض اللغات تبدأ الأسبوع يوم الاثنين، بينما تبدأ اللغات الأخرى يوم الأحد.

أماكن إقامة

periods

النوع: Array<OpeningHoursPeriod>

فترات الافتتاح التي تغطي كل يوم من الأسبوع، بدءًا من الأحد، بترتيب زمني. ولا يتضمن الأيام التي لا يتم فيها فتح هذا المكان.

weekdayDescriptions

النوع: Array<string>

مصفوفة من سبعة سلاسل تمثّل ساعات العمل المنسّقة لكل يوم من أيام الأسبوع. ستعمل خدمة "الأماكن" على تنسيق ساعات العمل وأقلمةها بشكلٍ مناسب للغة الحالية. ويعتمد ترتيب العناصر في هذه المصفوفة على اللغة. وبعض اللغات تبدأ الأسبوع يوم الاثنين، بينما تبدأ اللغات الأخرى يوم الأحد.

فئة OpeningHoursPeriod

صف واحد (google.maps.places.OpeningHoursPeriod)

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

أماكن إقامة
`close`	النوع: `OpeningHoursPoint optional` وقت الإغلاق للمكان.
`open`	النوع: `OpeningHoursPoint` حان وقت المكان.

فئة OpeningHoursPoint

صف واحد (google.maps.places.OpeningHoursPoint)

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

أماكن إقامة
`day`	النوع: `number` اليوم من الأسبوع، كرقم في النطاق [0، 6]، بدءًا من الأحد. على سبيل المثال، 2 يُقصد بهما الثلاثاء.
`hour`	النوع: `number` ساعة OpeningHoursPoint.time كرقم في النطاق [0, 23]. سيتم الإبلاغ عن ذلك في المنطقة الزمنية للمكان.
`minute`	النوع: `number` الدقيقة الخاصة بـ OpeningHoursPoint.time كرقم في النطاق [0, 59]. سيتم الإبلاغ عن ذلك في المنطقة الزمنية للمكان.

صورة الفئة

صف واحد (google.maps.places.Photo)

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

أماكن إقامة
`authorAttributions`	النوع: `Array<AuthorAttribution>` نص الإحالة الذي سيتم عرضه لهذه الصورة.
`heightPx`	النوع: `number` ارتفاع الصورة بالبكسل.
`widthPx`	النوع: `number` عرض الصورة بالبكسل.

الطُرق
`getURI`	`getURI([options])` المعلّمات: `options`: `PhotoOptions optional` قيمة العرض: `string` تعرض عنوان URL للصورة المقابل للخيارات المحدّدة.

فئة المؤلف

صف واحد (google.maps.places.AuthorAttribution)

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

أماكن إقامة
`displayName`	النوع: `string` اسم المؤلف لهذه النتيجة.
`photoURI`	النوع: `string optional` معرّف الموارد المنتظم (URI) لصورة المؤلف لهذه النتيجة. وقد لا يكون هذا متاحًا دائمًا.
`uri`	النوع: `string optional` معرّف الموارد المنتظم (URI) للملف الشخصي للمؤلف لهذه النتيجة.

فئة PlusCode

صف واحد (google.maps.places.PlusCode)

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

أماكن إقامة
`compoundCode`	النوع: `string optional` رمز علامة جمع يتضمّن درجة 1/8000 من الدرجة بمقدار 1/8000 من منطقة الدرجة حيث يتم إسقاط الأحرف الأربعة الأولى (رمز المنطقة) واستبدالها بوصف محلي. على سبيل المثال، "9G8F+5W زيورخ، سويسرا".
`globalCode`	النوع: `string optional` رمز علامة جمع يتضمّن درجة 1/8000 درجة من الدرجة 1/8000 على سبيل المثال، "8FVC9G8F+5W".

مراجعة الفئة

صف واحد (google.maps.places.Review)

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

أماكن إقامة
`authorAttribution`	النوع: `AuthorAttribution optional` المُراجع
`publishTime`	النوع: `Date optional`
`rating`	النوع: `number optional` تمثّل هذه السمة تقييم هذه المراجعة، تتراوح قيمتها بين 1.0 و5.0 (شاملة).
`relativePublishTimeDescription`	النوع: `string optional` سلسلة من الوقت الأخير المنسّق تعبّر عن وقت المراجعة بالنسبة إلى الوقت الحالي باستخدام نموذج مناسب للغة والبلد. على سبيل المثال، ""قبل شهر".
`text`	النوع: `string optional` تمثّل هذه السمة نص المراجعة.
`textLanguageCode`	النوع: `string optional` رمز لغة مجموعة مهندسي شبكة الإنترنت (IETF) يشير إلى اللغة التي تمت كتابة هذه المراجعة بها. تجدر الإشارة إلى أنّ هذا الرمز يشمل فقط علامة اللغة الرئيسية بدون أي علامة ثانوية تشير إلى البلد أو المنطقة. على سبيل المثال، يتم وضع علامة `'en'` على جميع المراجعات باللغة الإنجليزية بدلاً من "en-AU" أو "en-UK".

ثوابت PriceLevel

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

تعداد مستوى السعر لعناصر المكان.

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

ثوابت
`EXPENSIVE`
`FREE`
`INEXPENSIVE`
`MODERATE`
`VERY_EXPENSIVE`

Place (beta)

مكان المكان

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

الطرق الثابتة

أماكن إقامة

الطُرق

واجهة PlaceOptions

أماكن إقامة

فئةAddressPlugins

أماكن إقامة

فئةالإحالة

أماكن إقامة

واجهة FetchFieldsRequest

أماكن إقامة

ساعات العمل

أماكن إقامة

فئة OpeningHoursPeriod

أماكن إقامة

فئة OpeningHoursPoint

أماكن إقامة

صورة الفئة

أماكن إقامة

الطُرق

فئة المؤلف

أماكن إقامة

فئة PlusCode

أماكن إقامة

مراجعة الفئة

أماكن إقامة

ثوابت PriceLevel

ثوابت