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)
  },
  "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. لاسترداد جميع الكيانات السياسية التي تحتوي على عنوان محدّد، عليك استخدام الترميز الجغرافي العكسي، مع تمرير خط العرض/خط الطول للعنوان كمَعلمة للطلب. - لا يمكن ضمان بقاء تنسيق الرد كما هو بين الطلبات. على وجه التحديد، يختلف عدد عناصر addressComponents حسب العنوان المطلوب، ويمكن أن يتغير بمرور الوقت للعنوان نفسه. يمكن للمكون تغيير موضعه في الصفيفة. يمكن أن يتغير نوع المكون. قد يكون هناك مكوِّن غير متوفر في رد لاحق.
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

عنوان المكان في تنسيق DKIM لـ adr: 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)

معلومات حول خيارات شحن المركبات الكهربائية
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) هو مرجع موقع بتنسيقين: رمز عام يحدد 14MX14m (1/8000 من الدرجة) أو مستطيلاً أصغر حجمًا، ورمزًا مركّبًا، حيث يتم استبدال البادئة بالموقع المرجعي.

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

string

الرمز العالمي للمكان (الكامل)، مثل "9FWM33GV+HQ"، الذي يمثّل مساحة 1/8000 x 1/8000 درجة (حوالي 14 × 14 متر)
compoundCode

string

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

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 "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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)

سلسلة type تُستخدم لتحديد نوع ساعات العمل الثانوية.
specialDays[]

object (SpecialDay)

المعلومات المنظَّمة للأيام الخاصة التي تقع خلال الفترة التي تغطيها ساعات العمل المعروضة. الأيام الخاصة هي الأيام التي قد تؤثّر على ساعات العمل في مكان معيّن، مثل يوم عيد الميلاد. يتم ضبطها على ساعات OpeningHours الحالية و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 "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

معلومات عن محطة شحن المركبة الكهربائية التي تستضيفها في Place. تتم إضافة المصطلحات التالية إلى 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 "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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
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 مقبس حائط غير محدَّد

الطُرق

autocomplete

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

get

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

searchNearby

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

searchText

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