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)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "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

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

object (AddressComponent)

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

object (PlusCode)

رمز الموقع المفتوح لخط العرض/خط الطول للمكان
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][google.foo.OpeningHours.Period.open] تحتوي على [day][google.foo.Point.day] بالقيمة 0 و[hour][google.foo.Point.hour] بالقيمة 0 و[minute][google.foo.Point.minute] بالقيمة 0.
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)

ميزة تجريبية: يُرجى الاطّلاع على 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 للحصول على مزيد من التفاصيل.

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

object (ContainingPlace)

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

object (AddressDescriptor)

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

object (PriceRange)

نطاق الأسعار المرتبط بمكان
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.

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)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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)

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

string

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

enum (SecondaryHoursType)

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

object (SpecialDay)

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

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
nextCloseTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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)

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

صورة

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

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

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

يجب أن يكون طابعًا زمنيًا بالتنسيق 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 الإصدار 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 "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 موصل من النوع 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 مقبس حائط غير محدَّد

GenerativeSummary

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

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

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

object (LocalizedText)

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

string

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

object (LocalizedText)

الوصف التفصيلي للمكان
descriptionFlagContentUri

string

رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة مع ملخّص الوصف
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)
    }
  ],
  "flagContentUri": string
}
الحقول
contentBlocks[]

object (ContentBlock)

وحدات المحتوى التي تشكّل ملخّص المنطقة يتضمّن كل قسم موضوعًا منفصلاً عن المنطقة.
flagContentUri

string

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

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 للحصول على مزيد من التفاصيل.

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

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)

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

الطُرق

autocomplete

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

get

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

searchNearby

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

searchText

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