REST Resource: places

المرجع: مكان

جميع المعلومات التي تمثل المكان.

تمثيل JSON
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  }
}
الحقول
name

string

اسم مورد هذا المكان، بالتنسيق places/{placeId}. يمكن استخدامه للبحث عن المكان.

id

string

المعرّف الفريد للمكان.

displayName

object (LocalizedText)

تمثّل هذه السمة الاسم المترجم للمكان، وهو مناسب كوصف قصير يسهل على المستخدمين قراءته. على سبيل المثال، "Google سيدني" أو "ستاربكس" أو "بيرمونت" وما إلى ذلك.

types[]

string

مجموعة من العلامات من النوع لهذه النتيجة. على سبيل المثال: "سياسة" و"المنطقة المحلية". للحصول على القائمة الكاملة للقيم المحتملة، راجع الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.

primaryType

string

النوع الأساسي للنتيجة المقدمة. ويجب أن يكون هذا النوع أحد الأنواع المتوافقة مع Places API. على سبيل المثال، "مطعم" أو "مقهى" أو "مطار" وما إلى ذلك. ولا يمكن أن يكون المكان إلا نوعًا أساسيًا واحدًا. للحصول على القائمة الكاملة للقيم المحتملة، راجع الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.

primaryTypeDisplayName

object (LocalizedText)

تمثّل هذه السمة الاسم المعروض للنوع الأساسي، بما يتناسب مع لغة الطلب، إذا كان ذلك منطبقًا. للحصول على القائمة الكاملة للقيم المحتملة، راجع الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.

nationalPhoneNumber

string

رقم هاتف خاص بالمكان ويمكن لشخص عادي قراءته، بتنسيق وطني

internationalPhoneNumber

string

رقم هاتف خاص بالمكان يمكن لشخص عادي قراءته، بتنسيق دولي

formattedAddress

string

عنوان كامل يمكن لشخص عادي قراءته لهذا المكان

shortFormattedAddress

string

تمثّل هذه السمة عنوانًا قصيرًا لهذا المكان يمكن لشخص عادي قراءته.

addressComponents[]

object (AddressComponent)

عناصر متكرّرة لكل مستوى منطقة محلية. يُرجى ملاحظة الحقائق التالية حول صفيف addressComponents[]: - قد يحتوي صفيف مكونات العنوان على مكونات أكثر من formatAddress. - لا تتضمّن المصفوفة بالضرورة جميع الكيانات السياسية التي تحتوي على عنوان، باستثناء تلك المدرَجة في تنسيق العنوان المنسَّق. لاسترداد جميع الكيانات السياسية التي تحتوي على عنوان محدد، يجب استخدام الترميز الجغرافي العكسي، وتمرير خط العرض/الطول للعنوان كمعلمة للطلب. - ليس هناك ما يضمن بقاء تنسيق الرد كما هو بين الطلبات. وعلى وجه الخصوص، يختلف عدد مكونات العنوان بناءً على العنوان المطلوب ويمكن أن يتغير بمرور الوقت للعنوان نفسه. يمكن للمكون تغيير موضعه في الصفيف. يمكن أن يتغير نوع المكوِّن. قد يكون مكون معيّن مفقودًا في رد لاحق.

plusCode

object (PlusCode)

رمز Plus Codes لموقع المكان في خط العرض/الطول.

location

object (LatLng)

الموقع الجغرافي لهذا المكان.

viewport

object (Viewport)

إطار عرض مناسب لعرض المكان على خريطة بحجم متوسط.

rating

number

تقييم يتراوح بين 1.0 و5.0 استنادًا إلى مراجعات المستخدمين لهذا المكان

googleMapsUri

string

عنوان URL يوفر المزيد من المعلومات عن هذا المكان.

websiteUri

string

الموقع الإلكتروني الموثوق لهذا المكان، على سبيل المثال للأعمال" الرئيسية. بالنسبة إلى الأماكن التي هي جزء من سلسلة (على سبيل المثال، متجر IKEA)، ستكون هذه المجموعة عادةً الموقع الإلكتروني للمتجر الفردي، وليس للسلسلة بأكملها.

reviews[]

object (Review)

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

regularOpeningHours

object (OpeningHours)

ساعات العمل العادية.

photos[]

object (Photo)

معلومات (بما في ذلك المراجع) عن صور هذا المكان ويمكن إرجاع 10 صور كحدّ أقصى.

adrFormatAddress

string

عنوان المكان بتنسيق adr Microformat: http://microformats.org/wiki/adr.

businessStatus

enum (BusinessStatus)

حالة النشاط التجاري للمكان.

priceLevel

enum (PriceLevel)

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

attributions[]

object (Attribution)

يشير ذلك المصطلح إلى مجموعة من مزوِّدي البيانات يجب عرضها مع هذه النتيجة.

iconMaskBaseUri

string

عنوان URL تم اقتطاعه لقناع رمز. يمكن للمستخدم الوصول إلى نوع رمز مختلف من خلال إلحاق نوع اللاحقة في النهاية (مثل " .svg" أو " .png").

iconBackgroundColor

string

لون الخلفية لـ icon_mask بتنسيق سداسي، على سبيل المثال #909CE1.

currentOpeningHours

object (OpeningHours)

ساعات العمل للأيام السبعة المقبلة (بما في ذلك اليوم). تبدأ الفترة الزمنية في منتصف الليل من تاريخ الطلب وتنتهي في الساعة 11:59 مساءً بعد ستة أيام. يتضمن هذا الحقل الحقل الفرعي specialDays الذي يشير إلى جميع الساعات، والذي يتم ضبطه للتواريخ التي لها ساعات استثنائية.

currentSecondaryOpeningHours[]

object (OpeningHours)

يحتوي على مجموعة من الإدخالات للأيام السبعة المقبلة بما في ذلك معلومات حول الساعات الثانوية للنشاط التجاري. تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدد مطعم ساعات العمل في السيارة أو ساعات التسليم كساعات ثانوية. يملأ هذا الحقل الحقل الفرعي للنوع، الذي يتم اختياره من قائمة محددة مسبقًا لأنواع ساعات العمل (مثل DRIVE_THROUGH أو PICKUP أو TakeOUT) استنادًا إلى أنواع الأماكن. يتضمن هذا الحقل الحقل الفرعي specialDays الذي يشير إلى جميع الساعات، والذي يتم ضبطه للتواريخ التي لها ساعات استثنائية.

regularSecondaryOpeningHours[]

object (OpeningHours)

يحتوي على مجموعة من الإدخالات لمعلومات حول ساعات العمل الثانوية المنتظمة من النشاط التجاري. تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدد مطعم ساعات العمل في السيارة أو ساعات التسليم كساعات ثانوية. يملأ هذا الحقل الحقل الفرعي للنوع، الذي يتم اختياره من قائمة محددة مسبقًا لأنواع ساعات العمل (مثل DRIVE_THROUGH أو PICKUP أو TakeOUT) استنادًا إلى أنواع الأماكن.

editorialSummary

object (LocalizedText)

يحتوي على ملخّص للمكان يتألف الملخّص من نظرة عامة نصية، ويشمل أيضًا رمز اللغة الخاص بها، إذا كان ذلك منطبقًا. يجب تقديم نص الملخّص كما هو، ولا يمكن تعديله أو تغييره.

paymentOptions

object (PaymentOptions)

خيارات الدفع التي يقبلها المكان إذا لم تتوفر بيانات خيار الدفع، سيتم إلغاء تعيين حقل خيار الدفع.

parkingOptions

object (ParkingOptions)

خيارات مواقف السيارات التي يقدّمها المكان

subDestinations[]

object (SubDestination)

قائمة بالوجهات الفرعية المرتبطة بالمكان.

fuelOptions

object (FuelOptions)

أحدث المعلومات حول خيارات الوقود في محطة وقود يتم تعديل هذه المعلومات بشكل منتظم.

evChargeOptions

object (EVChargeOptions)

معلومات عن خيارات شحن المركبات الكهربائية

generativeSummary

object (GenerativeSummary)

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

ملخّص من إنشاء الذكاء الاصطناعي للمكان

areaSummary

object (AreaSummary)

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

ملخّص من إنشاء الذكاء الاصطناعي للمنطقة التي يقع فيها المكان

utcOffsetMinutes

integer

يختلف عدد الدقائق في المنطقة الزمنية لهذا المكان حاليًا عن التوقيت العالمي المنسَّق (UTC). يتم التعبير عن ذلك بالدقائق لإتاحة المناطق الزمنية التي يقابلها كسور من الساعة، مثل. X ساعة و15 دقيقة.

userRatingCount

integer

إجمالي عدد المراجعات (التي تحتوي على نص أو بدونه) لهذا المكان

takeout

boolean

تُحدِّد ما إذا كان النشاط التجاري يتيح طلب الوجبات لتناولها خارج المطعم.

delivery

boolean

تُحدِّد هذه السمة ما إذا كان النشاط التجاري يتيح خدمات التوصيل.

dineIn

boolean

تحدِّد هذه السمة ما إذا كان النشاط التجاري يوفّر خيارات جلوس داخلية أو خارجية.

curbsidePickup

boolean

تُحدِّد هذه السمة ما إذا كان النشاط التجاري يتيح خدمة الاستلام من السيارة.

reservable

boolean

لتحديد ما إذا كان المكان يسمح بإجراء الحجوزات.

servesBreakfast

boolean

تحدِّد هذه السمة ما إذا كان المكان يقدّم الفطور.

servesLunch

boolean

تحدد ما إذا كان المكان يقدم الغداء.

servesDinner

boolean

تحدِّد هذه السمة ما إذا كان المكان يقدّم العشاء.

servesBeer

boolean

لتحديد ما إذا كان المكان يقدّم البيرة.

servesWine

boolean

لتحديد ما إذا كان المكان يقدم النبيذ.

servesBrunch

boolean

يحدد ما إذا كان المكان يقدم وجبات الإفطار المتأخر.

servesVegetarianFood

boolean

لتحديد ما إذا كان المكان يقدم الطعام النباتي.

outdoorSeating

boolean

يضم الفندق أماكن جلوس في الهواء الطلق.

liveMusic

boolean

ويقدم المكان عروضًا موسيقية حية.

menuForChildren

boolean

يضم المكان قائمة طعام للأطفال.

servesCocktails

boolean

يقدّم المكان مشروبات الكوكتيل.

servesDessert

boolean

يقدّم المكان الحلويات.

servesCoffee

boolean

يقدم المكان القهوة.

goodForChildren

boolean

المكان جيد للأطفال.

allowsDogs

boolean

يسمح الفندق باصطحاب الكلاب.

restroom

boolean

يضم المكان دورة مياه.

goodForGroups

boolean

يستوعب المكان مجموعات.

goodForWatchingSports

boolean

المكان مناسب لمشاهدة الألعاب الرياضية.

accessibilityOptions

object (AccessibilityOptions)

تشير هذه السمة إلى معلومات حول خيارات تسهيل الاستخدام التي يقدّمها أحد الأماكن.

LocalizedText

صيغة مترجمة لنص بلغة معيّنة.

تمثيل JSON
{
  "text": string,
  "languageCode": string
}
الحقول
text

string

سلسلة مترجمة باللغة المقابلة لـ languageCode أدناه.

languageCode

string

رمز اللغة BCP-47 في النص، مثل "en-US" أو "sr-Latn".

لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

AddressComponent

تمثّل هذه السمة المكوّنات المنظَّمة التي تشكّل العنوان المنسَّق، إذا كانت هذه المعلومات متاحة.

تمثيل JSON
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
الحقول
longText

string

وصف النص الكامل أو اسم مكوِّن العنوان. على سبيل المثال، قد يحتوي مكوّن العنوان للبلد في أستراليا على long_name في "أستراليا".

shortText

string

تمثّل هذه السمة اسمًا نصيًا مختصرًا لمكوّن العنوان، إذا كان متاحًا. على سبيل المثال، قد يحتوي عنصر العنوان لدولة أستراليا على اسم Short_name لكلمة "AU".

types[]

string

مصفوفة تشير إلى أنواع مكوِّن العنوان.

languageCode

string

تشير هذه السمة إلى اللغة المستخدمة لتنسيق هذه المكوّنات، بتدوين CLDR.

PlusCode

رمز Plus Codes (http://plus.codes) هو مرجع موقع جغرافي بتنسيقَين: رمز عام يحدّد 14 م في 14 م (1/8000 من الدرجة) أو مستطيل أصغر، ورمز مركّب، مع استبدال البادئة بموقع مرجعي.

تمثيل JSON
{
  "globalCode": string,
  "compoundCode": string
}
الحقول
globalCode

string

الرمز العالمي (الكامل) للمكان، مثل "9FWM33GV+HQ"، الذي يمثل مساحة 1/8000 في 1/8000 درجة (14 × 14 متر تقريبًا).

compoundCode

string

الرمز المركّب للمكان، مثل "33GV+HQ, Ramberg, Norway"، الذي يحتوي على لاحقة الرمز العام ويستبدل البادئة باسم منسق للكيان المرجعي.

LatLng

كائن يمثّل زوجًا من خط العرض/الطول ويتم التعبير عن ذلك في صورة زوج من الزوجين لتمثيل درجات الطول والعرض والدرجات. يجب أن يتوافق هذا العنصر مع معيار WGS84 ما لم يُذكر خلاف ذلك. يجب أن تكون القيم ضمن النطاقات التي تمت تسويتها.

تمثيل JSON
{
  "latitude": number,
  "longitude": number
}
الحقول
latitude

number

خط العرض بالدرجات. يجب أن يكون في النطاق [ -90.0، +90.0].

longitude

number

خط الطول بالدرجات. يجب أن يكون في النطاق [ -180.0، +180.0].

إطار العرض

إطار عرض لخط الطول والعرض، ويتم تمثيله كخطين قطريًا مقابل نقطتين low وhigh. يُعتبَر إطار العرض منطقة مغلقة، بمعنى أنه يتضمّن حدوده. يجب أن تتراوح حدود خطوط العرض بين -90 و90 درجة، ويجب أن تتراوح حدود خط الطول بين -180 و180 درجة كحد أقصى. تشمل الحالات المختلفة ما يلي:

  • إذا كانت low = high، يتكوّن إطار العرض من هذه النقطة الفردية.

  • إذا كان low.longitude > high.longitude، يتم قلب نطاق خط الطول (يتجاوز إطار العرض خط الطول 180 درجة).

  • إذا كانت قيمة low.longitude = -180 درجة وhigh.longitude = 180 درجة، يشمل إطار العرض جميع خطوط الطول.

  • إذا كانت low.longitude = 180 درجة وhigh.longitude = -180 درجة، يكون نطاق خط الطول فارغًا.

  • إذا كان low.latitude > high.latitude، نطاق خط العرض فارغ.

يجب تعبئة كل من low وhigh، ولا يمكن أن يكون المربّع الذي يتم تمثيله فارغًا (كما هو محدَّد في التعريفات أعلاه). سيؤدي إطار العرض الفارغ إلى حدوث خطأ.

على سبيل المثال، يشمل إطار العرض هذا مدينة نيويورك بالكامل:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

تمثيل JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
الحقول
low

object (LatLng)

مطلوب. النقطة المنخفضة في إطار العرض.

high

object (LatLng)

مطلوب. تمثّل هذه السمة النقطة العليا لإطار العرض.

مراجعة

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

تمثيل JSON
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}
الحقول
name

string

مرجع يمثّل مراجعة لهذا المكان ويمكن استخدامه للبحث عن مراجعة حول هذا المكان مرة أخرى (يُعرف أيضًا باسم "المورد" لواجهة برمجة التطبيقات: places/{placeId}/reviews/{review})

relativePublishTimeDescription

string

سلسلة من الزمن بتنسيق حديث يعبِّر عن وقت المراجعة مقارنةً بالوقت الحالي بتنسيق مناسب للغة والبلد

text

object (LocalizedText)

تمثّل هذه السمة النص المترجَم للمراجعة.

originalText

object (LocalizedText)

نص المراجعة بلغته الأصلية.

rating

number

رقم يتراوح بين 1.0 و5.0، ويسمى أيضًا عدد النجوم.

authorAttribution

object (AuthorAttribution)

مؤلف هذه المراجعة.

publishTime

string (Timestamp format)

طابع زمني للمراجعة

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

AuthorAttribution

معلومات حول مؤلف بيانات المحتوى الذي ينشئه المستخدمون مُستخدمة في Photo وReview

تمثيل JSON
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
الحقول
displayName

string

تمثّل هذه السمة اسم مؤلف Photo أو Review.

uri

string

تمثّل هذه السمة معرّف الموارد المنتظم (URI) لمؤلف Photo أو Review.

photoUri

string

معرّف الموارد المنتظم (URI) لصورة الملف الشخصي لمؤلف Photo أو Review

OpeningHours

معلومات عن ساعة العمل للمكان.

تمثيل JSON
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}
الحقول
periods[]

object (Period)

الفترات التي يفتح فيها هذا المكان خلال الأسبوع. تظهر الفترات بترتيب زمني، بدءًا من يوم الأحد حسب المنطقة الزمنية المحلية. تشير القيمة الفارغة (ولكن غير موجودة) إلى مكان غير مفتوح أبدًا، على سبيل المثال: لأنه مغلق مؤقتًا لإجراء أعمال التجديد.

weekdayDescriptions[]

string

سلاسل مترجمة تصف ساعات العمل في هذا المكان، سلسلة واحدة لكل يوم من أيام الأسبوع. سيكون هذا الحقل فارغًا إذا كانت ساعات العمل غير معروفة أو تعذّر تحويلها إلى نص مترجم. مثال: "الأحد: 18:00–06:00"

secondaryHoursType

enum (SecondaryHoursType)

سلسلة من النوع تُستخدَم لتحديد نوع الساعات الثانوية

specialDays[]

object (SpecialDay)

المعلومات المنظَّمة للأيام الخاصة التي تقع ضمن الفترة التي تغطيها ساعات العمل المعروضة. الأيام الخاصة هي الأيام التي قد تؤثر في ساعات العمل لأحد الأماكن، على سبيل المثال: يوم عيد الميلاد. يمكنك الضبط على "currentOpeningHours" وcurrentPrimaryOpeningHours إذا كانت هناك ساعات استثنائية.

openNow

boolean

هل هذا المكان مفتوح الآن؟ نحن موجودون دائمًا ما لم نفتقر إلى بيانات الوقت من اليوم أو المنطقة الزمنية لساعات العمل هذه.

نقطة

نقطة يظل المكان في حالة openNow.

تمثيل JSON
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
الحقول
open

object (Point)

الوقت الذي يبدأ فيه المكان مفتوحًا.

close

object (Point)

وقت بدء إغلاق المكان.

نقطة

نقاط تغيُّر الحالة

تمثيل JSON
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
الحقول
date

object (Date)

التاريخ حسب المنطقة الزمنية المحلية للمكان.

truncated

boolean

ما إذا تم اقتطاع نقطة النهاية هذه أم لا يحدث الاقتطاع عندما تكون الساعات الفعلية خارج الأوقات التي ننوي العودة فيها إلى الساعات، لذلك نقتطع الساعات إلى هذه الحدود. يضمن ذلك إرجاع 24 * 7 ساعات على الأكثر بدءًا من منتصف ليل يوم الطلب.

day

integer

يوم من الأسبوع، كعدد صحيح في النطاق من 0 إلى 6. 0 هو الأحد، و1 هو الاثنين، وهكذا.

hour

integer

الساعة مكونة من رقمين. تتراوح من 00 إلى 23.

minute

integer

الدقيقة من رقمين. تتراوح من 00 إلى 59.

التاريخ

يمثل تاريخ تقويم كاملاً أو جزئيًا، مثل عيد الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك أيًا مما يلي:

  • تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
  • شهر ويوم، بسنة صفرية (على سبيل المثال، ذكرى سنوية).
  • سنة بمفردها، بشهر صفري ويوم صفري.
  • سنة وشهر بيوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).

الأنواع ذات الصلة:

تمثيل JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

السنة من التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة.

month

integer

شهر من السنة. يجب أن تتراوح القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم.

day

integer

يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر، أو 0 لتحديد عام في حد ذاته أو تحديد سنة وشهر حيث لا يكون اليوم مهمًا.

SecondaryHoursType

يشير ذلك المصطلح إلى نوع يتم استخدامه لتحديد نوع الساعات الثانوية.

عمليات التعداد
SECONDARY_HOURS_TYPE_UNSPECIFIED القيمة التلقائية عند عدم تحديد نوع الساعة الثانوية.
DRIVE_THROUGH خدمة الطلب أثناء القيادة للمصارف أو المطاعم أو الصيدليات.
HAPPY_HOUR ساعة سعيدة.
DELIVERY ساعة التسليم
TAKEOUT ساعة طلب الوجبات لتناولها خارج المطعم
KITCHEN ساعة المطبخ.
BREAKFAST ساعة الإفطار.
LUNCH ساعة الغداء.
DINNER ساعة العشاء.
BRUNCH ساعة الإفطار المتأخر.
PICKUP ساعة الاستلام
ACCESS ساعات الدخول إلى أماكن التخزين.
SENIOR_HOURS ساعات العمل الخاصة لكبار السنّ.
ONLINE_SERVICE_HOURS ساعات عمل الخدمة على الإنترنت.

SpecialDay

المعلومات المنظَّمة للأيام الخاصة التي تقع ضمن الفترة التي تغطيها ساعات العمل المعروضة. الأيام الخاصة هي الأيام التي قد تؤثر في ساعات العمل لأحد الأماكن، على سبيل المثال: يوم عيد الميلاد.

تمثيل JSON
{
  "date": {
    object (Date)
  }
}
الحقول
date

object (Date)

تاريخ هذا اليوم الخاص.

صورة

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

تمثيل JSON
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}
الحقول
name

string

المُعرّف. مرجع يمثّل صورة المكان هذا ويمكن استخدامه للبحث عن صورة هذا المكان مرة أخرى (يُعرف أيضًا باسم "المورد" لواجهة برمجة التطبيقات: places/{placeId}/photos/{photo}).

widthPx

integer

الحد الأقصى للعرض المتاح، بالبكسل.

heightPx

integer

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

authorAttributions[]

object (AuthorAttribution)

مؤلفو هذه الصورة.

BusinessStatus

حالة النشاط التجاري للمكان.

عمليات التعداد
BUSINESS_STATUS_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
OPERATIONAL المؤسسة جاهزة، وليس بالضرورة مفتوحة الآن.
CLOSED_TEMPORARILY الفندق مغلق مؤقتًا.
CLOSED_PERMANENTLY الفندق مغلق نهائيًا.

PriceLevel

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

عمليات التعداد
PRICE_LEVEL_UNSPECIFIED مستوى السعر في المكان غير محدّد أو غير معروف.
PRICE_LEVEL_FREE يوفّر المكان خدمات مجانية.
PRICE_LEVEL_INEXPENSIVE يقدم المكان خدمات غير مكلفة.
PRICE_LEVEL_MODERATE يقدّم المكان خدمات بأسعار معتدلة.
PRICE_LEVEL_EXPENSIVE يقدم المكان خدمات باهظة الثمن.
PRICE_LEVEL_VERY_EXPENSIVE يقدم المكان خدمات باهظة الثمن.

تحديد المصدر

معلومات حول مزوّدي البيانات لهذا المكان

تمثيل JSON
{
  "provider": string,
  "providerUri": string
}
الحقول
provider

string

اسم مزوِّد بيانات المكان.

providerUri

string

معرف موارد منتظم (URI) لموفّر بيانات المكان.

PaymentOptions

خيارات الدفع التي يقبلها المكان

تمثيل JSON
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
الحقول
acceptsCreditCards

boolean

يقبل المكان بطاقات الائتمان كدفعة.

acceptsDebitCards

boolean

يقبل المكان بطاقات السحب الآلي كدفعة.

acceptsCashOnly

boolean

يقبل المكان الدفع نقدًا فقط. قد تظل الأماكن التي تحمل هذه السمة تقبل طرق دفع أخرى.

acceptsNfc

boolean

يقبل المكان عمليات الدفع عبر NFC.

ParkingOptions

معلومات حول خيارات ركن السيارة في المكان. يمكن لموقف السيارات دعم أكثر من خيار في نفس الوقت.

تمثيل JSON
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
الحقول
freeParkingLot

boolean

يضم المكان مواقف مجانية للسيارات.

paidParkingLot

boolean

يضم المكان مواقف سيارات برسوم مدفوعة.

freeStreetParking

boolean

يوفر المكان موقفًا مجانيًا للسيارات في الشارع.

paidStreetParking

boolean

يضم المكان موقفًا للسيارات برسوم مدفوعة.

valetParking

boolean

يقدّم المكان خدمة صفّ السيارات من قِبل موظفي الفندق.

freeGarageParking

boolean

يضم الفندق موقفًا مجانيًا للسيارات في مرآب.

paidGarageParking

boolean

يضمّ المكان مرآب سيارات برسوم مدفوعة.

SubDestination

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

تمثيل JSON
{
  "name": string,
  "id": string
}
الحقول
name

string

اسم المورد للوجهة الفرعية.

id

string

رقم تعريف المكان للوجهة الفرعية.

AccessibilityOptions

تشير هذه السمة إلى معلومات حول خيارات تسهيل الاستخدام التي يقدّمها أحد الأماكن.

تمثيل JSON
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
الحقول
wheelchairAccessibleParking

boolean

يوفر المكان موقفًا للسيارات صالح للكراسي المتحركة.

wheelchairAccessibleEntrance

boolean

تحتوي الأماكن على مدخل صالح للكراسي المتحركة.

wheelchairAccessibleRestroom

boolean

يحتوي المكان على دورة مياه صالحة للكراسي المتحركة.

wheelchairAccessibleSeating

boolean

يضم المكان أماكن جلوس صالحة للكراسي المتحركة.

FuelOptions

أحدث المعلومات حول خيارات الوقود في محطة وقود يتم تعديل هذه المعلومات بشكل منتظم.

تمثيل JSON
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
الحقول
fuelPrices[]

object (FuelPrice)

تعرض هذه السمة آخر سعر وقود معروف لكل نوع من أنواع الوقود في هذه المحطة. يتوفّر إدخال واحد لكل نوع وقود في هذه المحطة. الترتيب غير مهم.

FuelPrice

معلومات عن أسعار الوقود لنوع معيّن

تمثيل JSON
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
الحقول
type

enum (FuelType)

نوع الوقود

price

object (Money)

سعر الوقود.

updateTime

string (Timestamp format)

تاريخ آخر تعديل لسعر الوقود

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

FuelType

أنواع الوقود:

عمليات التعداد
FUEL_TYPE_UNSPECIFIED نوع الوقود غير محدّد.
DIESEL وقود الديزل
REGULAR_UNLEADED عادية بدون توجيه.
MIDGRADE متوسط.
PREMIUM Premium
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG غاز البترول المُسال
E80 E 80.
E85 E 85.
METHANE الميثان
BIO_DIESEL وقود ديزل حيوي
TRUCK_DIESEL شاحنة ديزل.

المال

يمثل مبلغًا من المال مع نوع العملة.

تمثيل JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
الحقول
currencyCode

string

تمثّل هذه السمة رمز العملة المكوَّن من ثلاثة أحرف والمحدّد في ISO 4217.

units

string (int64 format)

تمثّل هذه السمة الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة السمة currencyCode هي "USD"، تكون قيمة الوحدة الواحدة دولار أمريكي واحد.

nanos

integer

عدد وحدات نانو (10^-9) من الكمية. يجب أن تتراوح القيمة بين -999,999,999 و +999,999,999 أو أكثر. إذا كانت قيمة units موجبة، يجب أن تكون قيمة nanos موجبة أو صفرًا. إذا كانت قيمة units صفرًا، يمكن أن تكون قيمة nanos موجبة أو صفرية أو سالبة. إذا كانت units سالبة، يجب أن تكون قيمة nanos سالبة أو صفرًا. على سبيل المثال، يتم تمثيل $1.75 على النحو التالي: units=-1 وnanos=-750,000,000.

EVChargeOptions

معلومات حول محطة شحن المركبة الكهربائية المستضافة في المكان تتبع المصطلحات https://afdc.energy.gov/fuels/electricity_infrastructure.html يمكن أن يشحن منفذ واحد سيارة واحدة في كلّ مرّة. يحتوي منفذ واحد على موصِّل واحد أو أكثر. تتضمن محطة واحدة منفذًا واحدًا أو أكثر.

تمثيل JSON
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
الحقول
connectorCount

integer

عدد الموصّلات في هذه المحطة ومع ذلك، نظرًا لأن بعض المنافذ يمكن أن تحتوي على موصلات متعددة ولكنها قادرة فقط على شحن سيارة واحدة في كل مرة (على سبيل المثال)، قد يكون عدد الموصلات أكبر من العدد الإجمالي للسيارات التي يمكنها الشحن في وقت واحد.

connectorAggregation[]

object (ConnectorAggregation)

قائمة بمجموعات موصِّلات شحن المركبات الكهربائية التي تحتوي على موصِّلات من النوع نفسه ومعدّل الشحن نفسه

ConnectorAggregation

معلومات شحن المركبات الكهربائية مجمّعة حسب [type, maxChargeRateKw] تعرِض هذه السمة تجميع شحنة المركبات الكهربائية التي تحمل النوع نفسه والحدّ الأقصى لمعدّل الشحن بالكيلوواط.

تمثيل JSON
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
الحقول
type

enum (EVConnectorType)

نوع الموصِّل لهذا التجميع.

maxChargeRateKw

number

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

count

integer

عدد الموصلات في هذه التجميع.

availabilityLastUpdateTime

string (Timestamp format)

الطابع الزمني لآخر تعديل لمعلومات مدى توفُّر الموصل في هذه البيانات المجمّعة

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

availableCount

integer

عدد الموصلات المتاحة حاليًا في هذه الحزمة.

outOfServiceCount

integer

عدد الموصلات في هذه الحزمة غير متاحة حاليًا في الخدمة.

EVConnectorType

يمكنك الانتقال إلى http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 للحصول على سياق إضافي حول أنواع وصلات شحن المركبات الكهربائية.

عمليات التعداد
EV_CONNECTOR_TYPE_UNSPECIFIED موصِّل غير محدَّد.
EV_CONNECTOR_TYPE_OTHER أنواع الموصلات الأخرى.
EV_CONNECTOR_TYPE_J1772 موصل J1772 من النوع 1.
EV_CONNECTOR_TYPE_TYPE_2 موصّل IEC 62196 من النوع 2. وغالبًا ما يُشار إليه باسم MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO موصِّل نوع CHAdeMO
EV_CONNECTOR_TYPE_CCS_COMBO_1 نظام شحن مُجمَّع (AC وDC). استنادًا إلى SAE. وصلة النوع-1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 نظام شحن مُجمَّع (AC وDC). استنادًا إلى موصِّل النوع 2 من قناة Mennekes
EV_CONNECTOR_TYPE_TESLA موصل TESLA العام. وهذه المنصة هي نظام NACS في أمريكا الشمالية، ولكن قد لا تكون ضمن معيار NACS في أجزاء أخرى من العالم (على سبيل المثال، CCS Combo 2 (CCS2) أو GB/T). تعتبر هذه القيمة أقل تمثيلاً لنوع الموصل الفعلي، وتمثل بشكل أكبر القدرة على شحن مركبة علامة Tesla التجارية في محطة شحن تملكها Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T يتوافق نوع GB/T مع معيار GB/T في الصين. يشمل هذا النوع كل أنواع GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET مقبس حائط غير محدَّد

GenerativeSummary

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

ملخّص من إنشاء الذكاء الاصطناعي للمكان

تمثيل JSON
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
الحقول
overview

object (LocalizedText)

نظرة عامة على المكان.

description

object (LocalizedText)

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

references

object (References)

يشير ذلك المصطلح إلى المراجع المستخدَمة لإنشاء وصف الملخّص.

المراجع

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

الإشارة إلى المحتوى من إنشاء الذكاء الاصطناعي التوليدي

تمثيل JSON
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
الحقول
reviews[]

object (Review)

المراجعات التي يتم استخدامها كمراجع

places[]

string

تمثّل هذه السمة قائمة أسماء الموارد للأماكن المُشار إليها. يمكن استخدام هذا الاسم في واجهات برمجة التطبيقات الأخرى التي تقبل أسماء موارد الأماكن.

AreaSummary

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

ملخّص من إنشاء الذكاء الاصطناعي للمنطقة التي يقع فيها المكان

تمثيل JSON
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}
الحقول
contentBlocks[]

object (ContentBlock)

وحدات المحتوى التي تتألف منها ملخّص المنطقة ويكون لكل مبنى موضوع منفصل عن المنطقة.

ContentBlock

جزء من المحتوى يمكن عرضه بشكل فردي.

تمثيل JSON
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
الحقول
topic

string

موضوع المحتوى، مثل "نظرة عامة" أو "مطعم".

content

object (LocalizedText)

المحتوى المرتبط بالموضوع

references

object (References)

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

المراجع ذات الصلة بكتلة المحتوى هذه

الطُرق

autocomplete

لعرض توقعات للإدخال المحدد.

get

يمكنك الحصول على تفاصيل المكان استنادًا إلى اسم المورد الخاص به، وهو سلسلة بتنسيق places/{place_id}.

searchNearby

البحث عن أماكن بالقرب من المواقع الجغرافية

searchText

البحث عن أماكن استنادًا إلى طلب بحث نصي.