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,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "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)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "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)
  },
  "pureServiceAreaBusiness": boolean
}
الحقول
name

string

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

string

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

object (LocalizedText)

الاسم المترجَم للمكان، وهو مناسب ليكون وصفًا قصيرًا يمكن لشخص عادي قراءته على سبيل المثال، "Google Sydney" و"Starbucks" و"Pyrmont" وما إلى ذلك.
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

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

object (PostalAddress)

العنوان بتنسيق العنوان البريدي
addressComponents[]

object (AddressComponent)

المكوّنات المتكرّرة لكل مستوى محلي يُرجى ملاحظة الحقائق التالية حول صفيف addressComponents[]: - قد يحتوي صفيف مكونات العنوان على مكونات أكثر من formattedAddress. - لا يتضمّن الصفيف بالضرورة جميع الكيانات السياسية التي تحتوي على عنوان، باستثناء تلك المضمّنة في formattedAddress. لاسترداد جميع الكيانات السياسية التي تحتوي على عنوان معيّن، عليك استخدام الترميز الجغرافي العكسي، مع ضبط خط العرض/خط الطول للعنوان كمَعلمة للطلب. - لا يمكن ضمان أن يظل تنسيق الردّ كما هو بين الطلبات. على وجه الخصوص، يختلف عدد 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)

ساعات العمل العادية يُرجى العِلم أنّه إذا كان المكان مفتوحًا دائمًا (24 ساعة)، لن يتم ضبط الحقل close. يمكن للعملاء الاعتماد على أنّ القيمة "مفتوح دائمًا" (24 ساعة) يتم تمثيلها كفترة open تحتوي على day بالقيمة 0 وhour بالقيمة 0 وminute بالقيمة 0.
timeZone

object (TimeZone)

المنطقة الزمنية لقاعدة بيانات المناطق الزمنية في IANA على سبيل المثال، "America/New_York".
photos[]

object (Photo)

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

string

عنوان المكان بتنسيق 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)

يحتوي على صفيف من الإدخالات للأيام السبعة التالية، بما في ذلك معلومات عن ساعات العمل الثانوية للنشاط التجاري. تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدّد مطعم ساعات العمل في خدمة "الاستلام من السيارة" أو ساعات العمل في خدمة التوصيل كساعات العمل الثانوية. يملؤ هذا الحقل الحقل الفرعي type، الذي يستمد بياناته من قائمة محدّدة مسبقًا بأنواع ساعات العمل (مثل DRIVE_THROUGH أو PICKUP أو TAKEOUT) استنادًا إلى أنواع المكان. يتضمّن هذا الحقل الحقل الفرعي specialDays لجميع الساعات، ويتم ضبطه للتواريخ التي تتضمّن ساعات عمل استثنائية.
regularSecondaryOpeningHours[]

object (OpeningHours)

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

ملخّص من إنشاء الذكاء الاصطناعي حول المكان
containingPlaces[]

object (ContainingPlace)

قائمة بالأماكن التي يقع فيها المكان الحالي
addressDescriptor

object (AddressDescriptor)

وصف عنوان المكان تتضمّن أوصاف العناوين معلومات إضافية تساعد في وصف موقع جغرافي باستخدام المعالم والمناطق. يمكنك الاطّلاع على التغطية الإقليمية لموصّف العنوان على https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
priceRange

object (PriceRange)

نطاق الأسعار المرتبط بمكان
reviewSummary

object (ReviewSummary)

ملخّص من إنشاء الذكاء الاصطناعي للمكان استنادًا إلى مراجعات المستخدمين
evChargeAmenitySummary

object (EvChargeAmenitySummary)

ملخّص وسائل الراحة بالقرب من محطة شحن المركبات الكهربائية
neighborhoodSummary

object (NeighborhoodSummary)

ملخّص لنقاط الاهتمام بالقرب من المكان
utcOffsetMinutes

integer

عدد الدقائق التي تختلف فيها المنطقة الزمنية لهذا المكان عن التوقيت العالمي المنسق حاليًا ويتم التعبير عن ذلك بالدقائق لتتوافق مع المناطق الزمنية التي يتم تعويضها بكسر ساعة، مثل 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)

معلومات حول خيارات تسهيل الاستخدام التي يوفّرها المكان
pureServiceAreaBusiness

boolean

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

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.

PostalAddress

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

في الاستخدام العادي، يتم إنشاء عنوان من خلال إدخال المستخدم أو من خلال استيراد البيانات الحالية، وذلك حسب نوع العملية.

نصائح حول إدخال العنوان أو تعديله:

  • استخدِم تطبيق مصغّر لعنوان متوافق مع الترجمة والنشر في جميع أنحاء العالم، مثل https://github.com/google/libaddressinput.

  • يجب عدم عرض عناصر واجهة مستخدِم للمستخدمين لإدخال الحقول أو تعديلها خارج البلدان التي يتم استخدام هذا الحقل فيها.

لمزيد من الإرشادات حول كيفية استخدام هذا المخطّط، يُرجى الاطّلاع على: https://support.google.com/business/answer/6397478.

تمثيل JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
الحقول
revision

integer

مراجعة المخطّط لـ PostalAddress. يجب ضبط هذه القيمة على 0، وهي آخر مراجعة.

يجب أن تكون جميع المراجعات الجديدة متوافقة مع المراجعات القديمة.
regionCode

string

مطلوب. رمز منطقة CLDR للبلد أو المنطقة التي يقع فيها العنوان ولا يتم استنتاج ذلك مطلقًا، ويعود الأمر للمستخدم للتأكّد من صحة القيمة. لمعرفة التفاصيل، يُرجى الانتقال إلى https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. على سبيل المثال، "CH" لسويسرا.
languageCode

string

اختياريّ. رمز اللغة BCP-47 لمحتوى هذا العنوان (إذا كان معروفًا) غالبًا ما تكون هذه هي لغة واجهة المستخدم لنموذج الإدخال، أو من المتوقّع أن تتطابق مع إحدى اللغات المستخدَمة في بلد/منطقة العنوان أو ما يعادلها من الترجمة الصوتية. ويمكن أن يؤثر ذلك في التنسيق في بلدان معيّنة، ولكنه ليس ضروريًا لصحة البيانات ولن يؤثر أبدًا في أي عمليات تحقّق من الصحة أو عمليات أخرى غير ذات صلة بالتنسيق.

إذا لم تكن هذه القيمة معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة).

على سبيل المثال: "zh-Hant" و"ja" و"ja-Latn" و"en".
postalCode

string

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

string

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

string

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

string

اختياريّ. يشير هذا الحقل بشكل عام إلى جزء المدينة أو البلدة من العنوان. أمثلة: مدينة أمريكية، بلدية إيطالية، مدينة بريدية في المملكة المتحدة في المناطق التي لم يتم فيها تحديد المواقع الجغرافية بشكل جيد أو لا تتوافق مع هذه البنية، اترك الحقل locality فارغًا واستخدِم addressLines.
sublocality

string

اختياريّ. البلدة الفرعية للعنوان على سبيل المثال، يمكن أن يكون حيًا أو منطقة إدارية أو دائرة.
addressLines[]

string

أسطر عناوين غير منظَّمة تصف المستويات الدنيا للعنوان

ولأنّ القيم في addressLines لا تحتوي على معلومات عن النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال، "القاهرة، مصر")، من المهم أن يكون ترتيب السطر واضحًا. يجب أن يكون ترتيب سطور العنوان هو "ترتيب المظروف" للبلد أو المنطقة التي يقع فيها العنوان. في الأماكن التي يمكن أن يختلف فيها ذلك (مثل اليابان)، يتم استخدام address_language لجعل الأمر واضحًا (على سبيل المثال، "ja" للترتيب من الأكبر إلى الأصغر و "ja-Latn" أو "en" للترتيب من الأصغر إلى الأكبر). بهذه الطريقة، يمكن اختيار السطر الأكثر تحديدًا من العنوان استنادًا إلى اللغة.

يتكون الحد الأدنى المسموح به من بنية العنوان من regionCode مع وضع جميع المعلومات المتبقية في addressLines. يمكن تنسيق عنوان كهذا تقريبًا جدًا بدون ترميز جغرافي، ولكن لا يمكن إجراء أيّ استدلال دلالي بشأن أيّ من مكوّنات العنوان إلى أن يتم حلّه جزئيًا على الأقل.

إنّ إنشاء عنوان يحتوي فقط على regionCode وaddressLines ثم ترميزه جغرافيًا هو الطريقة المُقترَحة للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مواقع جغرافية أو مناطق إدارية).
recipients[]

string

اختياريّ. المستلِم المقيم في العنوان قد يحتوي هذا الحقل، في حالات معيّنة، على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على معلومات "العنوان المُرسَل إليه".
organization

string

اختياريّ. اسم المؤسسة في العنوان

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، رامبرغ، النرويج"، الذي يحتوي على اللاحقة للرمز الشامل ويستبدل البادئة باسم منسَّق لكيان مرجعي

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,
  "flagContentUri": string,
  "googleMapsUri": 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)

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

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
flagContentUri

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في المراجعة
googleMapsUri

string

رابط لعرض المراجعة على "خرائط Google"

AuthorAttribution

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

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

string

اسم مؤلف Photo أو Review
uri

string

معرّف الموارد المنتظم (URI) لمؤلف Photo أو Review
photoUri

string

عنوان URL لصورة الملف الشخصي لمؤلف Photo أو Review.

OpeningHours

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

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

object (Period)

ملاحظة: لا يعتمد ترتيب صفيف periods على ترتيب صفيف weekdayDescriptions. لا تفترض أنّها ستبدأ في اليوم نفسه.
weekdayDescriptions[]

string

سلاسل مترجَمة تصف ساعات عمل هذا المكان، سلسلة واحدة لكل يوم من أيام الأسبوع

ملاحظة: يتم تحديد ترتيب الأيام وبداية الأسبوع حسب اللغة والمنطقة. لا يعتمد ترتيب مصفوفة periods على ترتيب مصفوفة weekdayDescriptions. لا تفترض أنّها ستبدأ في اليوم نفسه.

سيكون فارغًا إذا كانت ساعات العمل غير معروفة أو تعذّر تحويلها إلى نص مترجَم. مثال: "الأحد: من الساعة 6:00 صباحًا حتى الساعة 6:00 مساءً"
secondaryHoursType

enum (SecondaryHoursType)

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

object (SpecialDay)

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

string (Timestamp format)

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

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
nextCloseTime

string (Timestamp format)

المرة التالية التي تنتهي فيها فترة ساعات العمل الحالية، والتي يمكن أن تمتد إلى 7 أيام في المستقبل لا يتمّ ملء هذا الحقل إلّا إذا كانت فترة ساعات العمل نشطة في وقت عرض الطلب.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
openNow

boolean

ما إذا كانت فترة ساعات العمل نشطة حاليًا بالنسبة إلى ساعات العمل العادية وساعات العمل الحالية، يشير هذا الحقل إلى ما إذا كان المكان مفتوحًا. بالنسبة إلى ساعات العمل الثانوية وساعات العمل الثانوية الحالية، يشير هذا الحقل إلى ما إذا كانت ساعات العمل الثانوية لهذا المكان نشطة.

نقطة

الفترة التي يظل فيها المكان في حالة "مفتوح الآن"

تمثيل 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

الساعة بتنسيق 24 ساعة تتراوح بين 0 و23.
minute

integer

دقيقة واحدة. تتراوح بين 0 و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)

تاريخ هذا اليوم المميّز.

TimeZone

يمثّل منطقة زمنية من قاعدة بيانات المناطق الزمنية في IANA.

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

string

المنطقة الزمنية لقاعدة بيانات المناطق الزمنية في IANA على سبيل المثال، "America/New_York".
version

string

اختياريّ. رقم إصدار قاعدة بيانات المناطق الزمنية في IANA على سبيل المثال، "2019a".

صورة

معلومات عن صورة لمكان

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

string

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

integer

الحد الأقصى للعرض المسموح به، بالبكسل
heightPx

integer

الحد الأقصى للارتفاع المسموح به، بالبكسل
authorAttributions[]

object (AuthorAttribution)

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

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في الصورة
googleMapsUri

string

رابط لعرض الصورة على "خرائط Google"

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

عنوان URL لمزوّد بيانات المكان

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)

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

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

FuelType

أنواع الوقود

عمليات التعداد
FUEL_TYPE_UNSPECIFIED نوع الوقود غير محدّد
DIESEL وقود الديزل
DIESEL_PLUS وقود الديزل
REGULAR_UNLEADED بنزين عادي غير مزوّد بالرصاص
MIDGRADE متوسط
PREMIUM Premium
SP91 SP 91.
SP91_E10 ‫SP 91 E10
SP92 الإصدار 92 من حزمة الخدمة
SP95 SP 95
SP95_E10 ‫SP95 E10
SP98 SP 98.
SP99 SP 99.
SP100 ‫SP 100
LPG الغاز النفطي المسال
E80 ‫E 80
E85 ‫E 85.
E100 ‫E 100
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)

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

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
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 موصل من النوع 2 وفقًا لمعيار IEC 62196 يُشار إليها غالبًا باسم MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO موصّل من النوع CHAdeMO
EV_CONNECTOR_TYPE_CCS_COMBO_1 نظام الشحن المدمج (التيار المتناوب والمباشر) استنادًا إلى SAE موصل J-1772 من النوع 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 نظام الشحن المدمج (التيار المتناوب والمباشر) استنادًا إلى موصل Type-2 Mennekes
EV_CONNECTOR_TYPE_TESLA موصل TESLA العام يُستخدم هذا المعيار في أمريكا الشمالية، ولكن قد لا يكون مستخدمًا في أجزاء أخرى من العالم (مثل 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 مقبس حائط غير محدَّد
EV_CONNECTOR_TYPE_NACS نظام الشحن في أمريكا الشمالية (NACS)، وهو معيار SAE J3400

GenerativeSummary

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

تمثيل JSON 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
الحقول
overview

object (LocalizedText)

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

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في ملخّص النظرة العامة
disclosureText

object (LocalizedText)

رسالة الإفصاح عن التعامل مع الذكاء الاصطناعي "ملخّص باستخدام Gemini" (وأشكالها المترجَمة) وسيتم باللغة المحدّدة في الطلب إذا كانت متاحة.

ContainingPlace

معلومات عن المكان الذي يقع فيه هذا المكان

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

string

اسم المورد للمكان الذي يقع فيه هذا المكان
id

string

معرّف المكان الذي يقع فيه هذا المكان.

AddressDescriptor

وصف علائقي لموقع جغرافي تتضمّن مجموعة مصنّفة من المعالم المجاورة والمناطق المحيطة الدقيقة وعلاقتها بالموقع الجغرافي المستهدَف.

تمثيل JSON 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
الحقول
landmarks[]

object (Landmark)

قائمة مصنّفة بالمعالم القريبة يتم ترتيب المعالم الأكثر شهرة والأكثر قربًا أولاً.
areas[]

object (Area)

قائمة مصنّفة بالمناطق التي تحتوي على النقطة أو المجاورة لها يتم ترتيب المناطق الأكثر تمييزًا ودقة أولاً.

مَعلم

معلومات أساسية عن المَعلم وعلاقته بالموقع الجغرافي المستهدَف

المعالم هي أماكن بارزة يمكن استخدامها لوصف موقع جغرافي.

تمثيل JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
الحقول
name

string

اسم مرجع المَعلم
placeId

string

معرّف مكان المَعلم
displayName

object (LocalizedText)

الاسم المعروض للمعلم
types[]

string

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

enum (SpatialRelationship)

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

number

المسافة المستقيمة، بالكيلومترات، بين نقطة مركز الهدف ونقطة مركز المَعلم في بعض الحالات، يمكن أن تكون هذه القيمة أطول من travelDistanceMeters.
travelDistanceMeters

number

المسافة التي يتم قطعها، بالكيلومترات، على طول شبكة الطرق من الهدف إلى المَعلم، إذا كان معروفًا. ولا تأخذ هذه القيمة في الاعتبار وسيلة النقل، مثل المشي أو القيادة أو ركوب الدراجات.

SpatialRelationship

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

عمليات التعداد
NEAR هذه هي العلاقة التلقائية عندما لا ينطبق أيّ من الأنواع أدناه.
WITHIN يمتلك المَعلم شكلاً هندسيًا مكانيًا، ويكون الهدف ضمن حدوده.
BESIDE الهدف مجاور مباشرةً للمعلم.
ACROSS_THE_ROAD الهدف يقع مباشرةً مقابل المَعلم على الجانب الآخر من الطريق.
DOWN_THE_ROAD على المسار نفسه الذي يمر به المَعلم، ولكن ليس بجانبه أو على الجانب المقابل
AROUND_THE_CORNER ليست على المسار نفسه الذي يمر به المَعلم، ولكن يمكن الوصول إليها من خلال منعطف واحد.
BEHIND قريب من بنية المَعلمة ولكن بعيدًا عن مداخلها في الشارع

المساحة

معلومات عن المنطقة وعلاقة المنطقة بالموقع الجغرافي المستهدَف

تشمل المناطق المحليات الفرعية الدقيقة والأحياء والمجمعات الكبيرة المفيدة لوصف الموقع الجغرافي.

تمثيل JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
الحقول
name

string

اسم مورد المنطقة
placeId

string

معرّف المكان الخاص بالمنطقة
displayName

object (LocalizedText)

الاسم المعروض للمنطقة
containment

enum (Containment)

يحدِّد العلاقة المكانية بين الموقع الجغرافي المستهدَف والمنطقة.

الاحتواء

يحدِّد العلاقة المكانية بين الموقع الجغرافي المستهدَف والمنطقة.

عمليات التعداد
CONTAINMENT_UNSPECIFIED لم يتم تحديد حدود المحتوى.
WITHIN الموقع الجغرافي المستهدَف يقع ضمن منطقة المنطقة، بالقرب من المركز.
OUTSKIRTS الموقع الجغرافي المستهدَف يقع ضمن منطقة المنطقة، بالقرب من الحافة.
NEAR الموقع الجغرافي المستهدَف خارج منطقة البحث، ولكنه قريب.

PriceRange

نطاق الأسعار المرتبط بمكان يمكن عدم ضبط endPrice، ما يشير إلى نطاق بدون حدّ أقصى (مثل "أكثر من 100 دولار أمريكي").

تمثيل JSON 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
الحقول
startPrice

object (Money)

الحد الأدنى لنطاق السعر (شاملاً) يجب أن يكون السعر مساوياً لهذا المبلغ أو أعلى منه.
endPrice

object (Money)

الحدّ الأعلى لنطاق السعر (حصري). يجب أن يكون السعر أقل من هذا المبلغ.

ReviewSummary

ملخّص من إنشاء الذكاء الاصطناعي للمكان استنادًا إلى مراجعات المستخدمين

تمثيل JSON 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  },
  "reviewsUri": string
}
الحقول
text

object (LocalizedText)

ملخص مراجعات المستخدمين
flagContentUri

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في الملخّص
disclosureText

object (LocalizedText)

رسالة الإفصاح عن التعامل مع الذكاء الاصطناعي "ملخّص باستخدام Gemini" (وأشكالها المترجَمة) وسيتم باللغة المحدّدة في الطلب إذا كانت متاحة.
reviewsUri

string

رابط لعرض مراجعات هذا المكان على "خرائط Google"

EvChargeAmenitySummary

ملخّص وسائل الراحة القريبة من محطة شحن المركبات الكهربائية لا ينطبق ذلك إلا على الأماكن من النوع electric_vehicle_charging_station. نضمن تقديم حقل overview، في حين تكون الحقول الأخرى اختيارية.

تمثيل JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
الحقول
overview

object (ContentBlock)

نظرة عامة على وسائل الراحة المتاحة نضمن توفير هذه الميزة.
coffee

object (ContentBlock)

ملخص لخيارات المقاهي المجاورة
restaurant

object (ContentBlock)

ملخّص للمطاعم القريبة
store

object (ContentBlock)

ملخّص عن محطات الوقود القريبة
flagContentUri

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في الملخّص
disclosureText

object (LocalizedText)

رسالة الإفصاح عن التعامل مع الذكاء الاصطناعي "ملخّص باستخدام Gemini" (وأشكالها المترجَمة) وسيتم باللغة المحدّدة في الطلب إذا كانت متاحة.

ContentBlock

مجموعة من المحتوى يمكن عرضها بشكلٍ فردي

تمثيل JSON 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
الحقول
content

object (LocalizedText)

المحتوى ذي الصلة بالموضوع
referencedPlaces[]

string

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

NeighborhoodSummary

ملخّص لنقاط الاهتمام بالقرب من المكان

تمثيل JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
الحقول
overview

object (ContentBlock)

ملخّص عام عن الحي
description

object (ContentBlock)

وصف مفصّل للحي
flagContentUri

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في الملخّص
disclosureText

object (LocalizedText)

رسالة الإفصاح عن التعامل مع الذكاء الاصطناعي "ملخّص باستخدام Gemini" (وأشكالها المترجَمة) وسيتم باللغة المحدّدة في الطلب إذا كانت متاحة.

الطُرق

autocomplete

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

get

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

searchNearby

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

searchText

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