- المورد: مكان
- LocalizedText
- AddressComponent
- PlusCode
- LatLng
- إطار العرض
- مراجعة
- AuthorAttribution
- OpeningHours
- الدورة الشهرية
- نقطة
- التاريخ
- SecondaryHoursType
- SpecialDay
- الصورة
- BusinessStatus
- PriceLevel
- تحديد المصدر
- PaymentOptions
- ParkingOptions
- SubDestination
- AccessibilityOptions
- FuelOptions
- FuelPrice
- FuelType
- المال
- EVChargeOptions
- ConnectorAggregation
- EVConnectorType
- GenerativeSummary
- المراجع
- AreaSummary
- ContentBlock
- الطُرق
المرجع: مكان
جميع المعلومات التي تمثل المكان.
تمثيل JSON |
---|
{ "name": string, "id": string, "displayName": { object ( |
الحقول | |
---|---|
name |
اسم مورد هذا المكان، بالتنسيق |
id |
المعرّف الفريد للمكان. |
displayName |
تمثّل هذه السمة الاسم المترجم للمكان، وهو مناسب كوصف قصير يسهل على المستخدمين قراءته. على سبيل المثال، "Google سيدني" أو "ستاربكس" أو "بيرمونت" وما إلى ذلك. |
types[] |
مجموعة من العلامات من النوع لهذه النتيجة. على سبيل المثال: "سياسة" و"المنطقة المحلية". للحصول على القائمة الكاملة للقيم المحتملة، راجع الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types. |
primaryType |
النوع الأساسي للنتيجة المقدمة. ويجب أن يكون هذا النوع أحد الأنواع المتوافقة مع Places API. على سبيل المثال، "مطعم" أو "مقهى" أو "مطار" وما إلى ذلك. ولا يمكن أن يكون المكان إلا نوعًا أساسيًا واحدًا. للحصول على القائمة الكاملة للقيم المحتملة، راجع الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types. |
primaryTypeDisplayName |
تمثّل هذه السمة الاسم المعروض للنوع الأساسي، بما يتناسب مع لغة الطلب، إذا كان ذلك منطبقًا. للحصول على القائمة الكاملة للقيم المحتملة، راجع الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types. |
nationalPhoneNumber |
رقم هاتف خاص بالمكان ويمكن لشخص عادي قراءته، بتنسيق وطني |
internationalPhoneNumber |
رقم هاتف خاص بالمكان يمكن لشخص عادي قراءته، بتنسيق دولي |
formattedAddress |
عنوان كامل يمكن لشخص عادي قراءته لهذا المكان |
shortFormattedAddress |
تمثّل هذه السمة عنوانًا قصيرًا لهذا المكان يمكن لشخص عادي قراءته. |
addressComponents[] |
عناصر متكرّرة لكل مستوى منطقة محلية. يُرجى ملاحظة الحقائق التالية حول صفيف addressComponents[]: - قد يحتوي صفيف مكونات العنوان على مكونات أكثر من formatAddress. - لا تتضمّن المصفوفة بالضرورة جميع الكيانات السياسية التي تحتوي على عنوان، باستثناء تلك المدرَجة في تنسيق العنوان المنسَّق. لاسترداد جميع الكيانات السياسية التي تحتوي على عنوان محدد، يجب استخدام الترميز الجغرافي العكسي، وتمرير خط العرض/الطول للعنوان كمعلمة للطلب. - ليس هناك ما يضمن بقاء تنسيق الرد كما هو بين الطلبات. وعلى وجه الخصوص، يختلف عدد مكونات العنوان بناءً على العنوان المطلوب ويمكن أن يتغير بمرور الوقت للعنوان نفسه. يمكن للمكون تغيير موضعه في الصفيف. يمكن أن يتغير نوع المكوِّن. قد يكون مكون معيّن مفقودًا في رد لاحق. |
plusCode |
رمز Plus Codes لموقع المكان في خط العرض/الطول. |
location |
الموقع الجغرافي لهذا المكان. |
viewport |
إطار عرض مناسب لعرض المكان على خريطة بحجم متوسط. |
rating |
تقييم يتراوح بين 1.0 و5.0 استنادًا إلى مراجعات المستخدمين لهذا المكان |
googleMapsUri |
عنوان URL يوفر المزيد من المعلومات عن هذا المكان. |
websiteUri |
الموقع الإلكتروني الموثوق لهذا المكان، على سبيل المثال للأعمال" الرئيسية. بالنسبة إلى الأماكن التي هي جزء من سلسلة (على سبيل المثال، متجر IKEA)، ستكون هذه المجموعة عادةً الموقع الإلكتروني للمتجر الفردي، وليس للسلسلة بأكملها. |
reviews[] |
قائمة المراجعات عن هذا المكان، مرتّبة حسب مدى صلتها بموضوع البحث. يمكن إرجاع 5 مراجعات كحدّ أقصى. |
regularOpeningHours |
ساعات العمل العادية. |
photos[] |
معلومات (بما في ذلك المراجع) عن صور هذا المكان ويمكن إرجاع 10 صور كحدّ أقصى. |
adrFormatAddress |
عنوان المكان بتنسيق adr Microformat: http://microformats.org/wiki/adr. |
businessStatus |
حالة النشاط التجاري للمكان. |
priceLevel |
مستوى سعر المكان. |
attributions[] |
يشير ذلك المصطلح إلى مجموعة من مزوِّدي البيانات يجب عرضها مع هذه النتيجة. |
iconMaskBaseUri |
عنوان URL تم اقتطاعه لقناع رمز. يمكن للمستخدم الوصول إلى نوع رمز مختلف من خلال إلحاق نوع اللاحقة في النهاية (مثل " .svg" أو " .png"). |
iconBackgroundColor |
لون الخلفية لـ icon_mask بتنسيق سداسي، على سبيل المثال #909CE1. |
currentOpeningHours |
ساعات العمل للأيام السبعة المقبلة (بما في ذلك اليوم). تبدأ الفترة الزمنية في منتصف الليل من تاريخ الطلب وتنتهي في الساعة 11:59 مساءً بعد ستة أيام. يتضمن هذا الحقل الحقل الفرعي specialDays الذي يشير إلى جميع الساعات، والذي يتم ضبطه للتواريخ التي لها ساعات استثنائية. |
currentSecondaryOpeningHours[] |
يحتوي على مجموعة من الإدخالات للأيام السبعة المقبلة بما في ذلك معلومات حول الساعات الثانوية للنشاط التجاري. تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدد مطعم ساعات العمل في السيارة أو ساعات التسليم كساعات ثانوية. يملأ هذا الحقل الحقل الفرعي للنوع، الذي يتم اختياره من قائمة محددة مسبقًا لأنواع ساعات العمل (مثل DRIVE_THROUGH أو PICKUP أو TakeOUT) استنادًا إلى أنواع الأماكن. يتضمن هذا الحقل الحقل الفرعي specialDays الذي يشير إلى جميع الساعات، والذي يتم ضبطه للتواريخ التي لها ساعات استثنائية. |
regularSecondaryOpeningHours[] |
يحتوي على مجموعة من الإدخالات لمعلومات حول ساعات العمل الثانوية المنتظمة من النشاط التجاري. تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدد مطعم ساعات العمل في السيارة أو ساعات التسليم كساعات ثانوية. يملأ هذا الحقل الحقل الفرعي للنوع، الذي يتم اختياره من قائمة محددة مسبقًا لأنواع ساعات العمل (مثل DRIVE_THROUGH أو PICKUP أو TakeOUT) استنادًا إلى أنواع الأماكن. |
editorialSummary |
يحتوي على ملخّص للمكان يتألف الملخّص من نظرة عامة نصية، ويشمل أيضًا رمز اللغة الخاص بها، إذا كان ذلك منطبقًا. يجب تقديم نص الملخّص كما هو، ولا يمكن تعديله أو تغييره. |
paymentOptions |
خيارات الدفع التي يقبلها المكان إذا لم تتوفر بيانات خيار الدفع، سيتم إلغاء تعيين حقل خيار الدفع. |
parkingOptions |
خيارات مواقف السيارات التي يقدّمها المكان |
subDestinations[] |
قائمة بالوجهات الفرعية المرتبطة بالمكان. |
fuelOptions |
أحدث المعلومات حول خيارات الوقود في محطة وقود يتم تعديل هذه المعلومات بشكل منتظم. |
evChargeOptions |
معلومات عن خيارات شحن المركبات الكهربائية |
generativeSummary |
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل. ملخّص من إنشاء الذكاء الاصطناعي للمكان |
areaSummary |
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل. ملخّص من إنشاء الذكاء الاصطناعي للمنطقة التي يقع فيها المكان |
utcOffsetMinutes |
يختلف عدد الدقائق في المنطقة الزمنية لهذا المكان حاليًا عن التوقيت العالمي المنسَّق (UTC). يتم التعبير عن ذلك بالدقائق لإتاحة المناطق الزمنية التي يقابلها كسور من الساعة، مثل. X ساعة و15 دقيقة. |
userRatingCount |
إجمالي عدد المراجعات (التي تحتوي على نص أو بدونه) لهذا المكان |
takeout |
تُحدِّد ما إذا كان النشاط التجاري يتيح طلب الوجبات لتناولها خارج المطعم. |
delivery |
تُحدِّد هذه السمة ما إذا كان النشاط التجاري يتيح خدمات التوصيل. |
dineIn |
تحدِّد هذه السمة ما إذا كان النشاط التجاري يوفّر خيارات جلوس داخلية أو خارجية. |
curbsidePickup |
تُحدِّد هذه السمة ما إذا كان النشاط التجاري يتيح خدمة الاستلام من السيارة. |
reservable |
لتحديد ما إذا كان المكان يسمح بإجراء الحجوزات. |
servesBreakfast |
تحدِّد هذه السمة ما إذا كان المكان يقدّم الفطور. |
servesLunch |
تحدد ما إذا كان المكان يقدم الغداء. |
servesDinner |
تحدِّد هذه السمة ما إذا كان المكان يقدّم العشاء. |
servesBeer |
لتحديد ما إذا كان المكان يقدّم البيرة. |
servesWine |
لتحديد ما إذا كان المكان يقدم النبيذ. |
servesBrunch |
يحدد ما إذا كان المكان يقدم وجبات الإفطار المتأخر. |
servesVegetarianFood |
لتحديد ما إذا كان المكان يقدم الطعام النباتي. |
outdoorSeating |
يضم الفندق أماكن جلوس في الهواء الطلق. |
liveMusic |
ويقدم المكان عروضًا موسيقية حية. |
menuForChildren |
يضم المكان قائمة طعام للأطفال. |
servesCocktails |
يقدّم المكان مشروبات الكوكتيل. |
servesDessert |
يقدّم المكان الحلويات. |
servesCoffee |
يقدم المكان القهوة. |
goodForChildren |
المكان جيد للأطفال. |
allowsDogs |
يسمح الفندق باصطحاب الكلاب. |
restroom |
يضم المكان دورة مياه. |
goodForGroups |
يستوعب المكان مجموعات. |
goodForWatchingSports |
المكان مناسب لمشاهدة الألعاب الرياضية. |
accessibilityOptions |
تشير هذه السمة إلى معلومات حول خيارات تسهيل الاستخدام التي يقدّمها أحد الأماكن. |
LocalizedText
صيغة مترجمة لنص بلغة معيّنة.
تمثيل JSON |
---|
{ "text": string, "languageCode": string } |
الحقول | |
---|---|
text |
سلسلة مترجمة باللغة المقابلة لـ |
languageCode |
رمز اللغة 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 |
وصف النص الكامل أو اسم مكوِّن العنوان. على سبيل المثال، قد يحتوي مكوّن العنوان للبلد في أستراليا على long_name في "أستراليا". |
shortText |
تمثّل هذه السمة اسمًا نصيًا مختصرًا لمكوّن العنوان، إذا كان متاحًا. على سبيل المثال، قد يحتوي عنصر العنوان لدولة أستراليا على اسم Short_name لكلمة "AU". |
types[] |
مصفوفة تشير إلى أنواع مكوِّن العنوان. |
languageCode |
تشير هذه السمة إلى اللغة المستخدمة لتنسيق هذه المكوّنات، بتدوين CLDR. |
PlusCode
رمز Plus Codes (http://plus.codes) هو مرجع موقع جغرافي بتنسيقَين: رمز عام يحدّد 14 م في 14 م (1/8000 من الدرجة) أو مستطيل أصغر، ورمز مركّب، مع استبدال البادئة بموقع مرجعي.
تمثيل JSON |
---|
{ "globalCode": string, "compoundCode": string } |
الحقول | |
---|---|
globalCode |
الرمز العالمي (الكامل) للمكان، مثل "9FWM33GV+HQ"، الذي يمثل مساحة 1/8000 في 1/8000 درجة (14 × 14 متر تقريبًا). |
compoundCode |
الرمز المركّب للمكان، مثل "33GV+HQ, Ramberg, Norway"، الذي يحتوي على لاحقة الرمز العام ويستبدل البادئة باسم منسق للكيان المرجعي. |
LatLng
كائن يمثّل زوجًا من خط العرض/الطول ويتم التعبير عن ذلك في صورة زوج من الزوجين لتمثيل درجات الطول والعرض والدرجات. يجب أن يتوافق هذا العنصر مع معيار WGS84 ما لم يُذكر خلاف ذلك. يجب أن تكون القيم ضمن النطاقات التي تمت تسويتها.
تمثيل JSON |
---|
{ "latitude": number, "longitude": number } |
الحقول | |
---|---|
latitude |
خط العرض بالدرجات. يجب أن يكون في النطاق [ -90.0، +90.0]. |
longitude |
خط الطول بالدرجات. يجب أن يكون في النطاق [ -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 ( |
الحقول | |
---|---|
low |
مطلوب. النقطة المنخفضة في إطار العرض. |
high |
مطلوب. تمثّل هذه السمة النقطة العليا لإطار العرض. |
مراجعة
تمثّل هذه السمة معلومات حول مراجعة مكان.
تمثيل JSON |
---|
{ "name": string, "relativePublishTimeDescription": string, "text": { object ( |
الحقول | |
---|---|
name |
مرجع يمثّل مراجعة لهذا المكان ويمكن استخدامه للبحث عن مراجعة حول هذا المكان مرة أخرى (يُعرف أيضًا باسم "المورد" لواجهة برمجة التطبيقات: |
relativePublishTimeDescription |
سلسلة من الزمن بتنسيق حديث يعبِّر عن وقت المراجعة مقارنةً بالوقت الحالي بتنسيق مناسب للغة والبلد |
text |
تمثّل هذه السمة النص المترجَم للمراجعة. |
originalText |
نص المراجعة بلغته الأصلية. |
rating |
رقم يتراوح بين 1.0 و5.0، ويسمى أيضًا عدد النجوم. |
authorAttribution |
مؤلف هذه المراجعة. |
publishTime |
طابع زمني للمراجعة طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
AuthorAttribution
معلومات حول مؤلف بيانات المحتوى الذي ينشئه المستخدمون مُستخدمة في Photo
وReview
تمثيل JSON |
---|
{ "displayName": string, "uri": string, "photoUri": string } |
الحقول | |
---|---|
displayName |
|
uri |
تمثّل هذه السمة معرّف الموارد المنتظم (URI) لمؤلف |
photoUri |
معرّف الموارد المنتظم (URI) لصورة الملف الشخصي لمؤلف |
OpeningHours
معلومات عن ساعة العمل للمكان.
تمثيل JSON |
---|
{ "periods": [ { object ( |
الحقول | |
---|---|
periods[] |
الفترات التي يفتح فيها هذا المكان خلال الأسبوع. تظهر الفترات بترتيب زمني، بدءًا من يوم الأحد حسب المنطقة الزمنية المحلية. تشير القيمة الفارغة (ولكن غير موجودة) إلى مكان غير مفتوح أبدًا، على سبيل المثال: لأنه مغلق مؤقتًا لإجراء أعمال التجديد. |
weekdayDescriptions[] |
سلاسل مترجمة تصف ساعات العمل في هذا المكان، سلسلة واحدة لكل يوم من أيام الأسبوع. سيكون هذا الحقل فارغًا إذا كانت ساعات العمل غير معروفة أو تعذّر تحويلها إلى نص مترجم. مثال: "الأحد: 18:00–06:00" |
secondaryHoursType |
سلسلة من النوع تُستخدَم لتحديد نوع الساعات الثانوية |
specialDays[] |
المعلومات المنظَّمة للأيام الخاصة التي تقع ضمن الفترة التي تغطيها ساعات العمل المعروضة. الأيام الخاصة هي الأيام التي قد تؤثر في ساعات العمل لأحد الأماكن، على سبيل المثال: يوم عيد الميلاد. يمكنك الضبط على "currentOpeningHours" وcurrentPrimaryOpeningHours إذا كانت هناك ساعات استثنائية. |
openNow |
هل هذا المكان مفتوح الآن؟ نحن موجودون دائمًا ما لم نفتقر إلى بيانات الوقت من اليوم أو المنطقة الزمنية لساعات العمل هذه. |
نقطة
نقطة يظل المكان في حالة openNow.
تمثيل JSON |
---|
{ "open": { object ( |
الحقول | |
---|---|
open |
الوقت الذي يبدأ فيه المكان مفتوحًا. |
close |
وقت بدء إغلاق المكان. |
نقطة
نقاط تغيُّر الحالة
تمثيل JSON |
---|
{
"date": {
object ( |
الحقول | |
---|---|
date |
التاريخ حسب المنطقة الزمنية المحلية للمكان. |
truncated |
ما إذا تم اقتطاع نقطة النهاية هذه أم لا يحدث الاقتطاع عندما تكون الساعات الفعلية خارج الأوقات التي ننوي العودة فيها إلى الساعات، لذلك نقتطع الساعات إلى هذه الحدود. يضمن ذلك إرجاع 24 * 7 ساعات على الأكثر بدءًا من منتصف ليل يوم الطلب. |
day |
يوم من الأسبوع، كعدد صحيح في النطاق من 0 إلى 6. 0 هو الأحد، و1 هو الاثنين، وهكذا. |
hour |
الساعة مكونة من رقمين. تتراوح من 00 إلى 23. |
minute |
الدقيقة من رقمين. تتراوح من 00 إلى 59. |
التاريخ
يمثل تاريخ تقويم كاملاً أو جزئيًا، مثل عيد الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك أيًا مما يلي:
- تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
- شهر ويوم، بسنة صفرية (على سبيل المثال، ذكرى سنوية).
- سنة بمفردها، بشهر صفري ويوم صفري.
- سنة وشهر بيوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).
الأنواع ذات الصلة:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
تمثيل JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
الحقول | |
---|---|
year |
السنة من التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة. |
month |
شهر من السنة. يجب أن تتراوح القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر. يجب أن تتراوح القيمة من 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 |
تاريخ هذا اليوم الخاص. |
صورة
تمثّل هذه السمة معلومات حول صورة مكان.
تمثيل JSON |
---|
{
"name": string,
"widthPx": integer,
"heightPx": integer,
"authorAttributions": [
{
object ( |
الحقول | |
---|---|
name |
المُعرّف. مرجع يمثّل صورة المكان هذا ويمكن استخدامه للبحث عن صورة هذا المكان مرة أخرى (يُعرف أيضًا باسم "المورد" لواجهة برمجة التطبيقات: |
widthPx |
الحد الأقصى للعرض المتاح، بالبكسل. |
heightPx |
تمثّل هذه السمة الحد الأقصى للارتفاع المتاح بالبكسل. |
authorAttributions[] |
مؤلفو هذه الصورة. |
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 |
اسم مزوِّد بيانات المكان. |
providerUri |
معرف موارد منتظم (URI) لموفّر بيانات المكان. |
PaymentOptions
خيارات الدفع التي يقبلها المكان
تمثيل JSON |
---|
{ "acceptsCreditCards": boolean, "acceptsDebitCards": boolean, "acceptsCashOnly": boolean, "acceptsNfc": boolean } |
الحقول | |
---|---|
acceptsCreditCards |
يقبل المكان بطاقات الائتمان كدفعة. |
acceptsDebitCards |
يقبل المكان بطاقات السحب الآلي كدفعة. |
acceptsCashOnly |
يقبل المكان الدفع نقدًا فقط. قد تظل الأماكن التي تحمل هذه السمة تقبل طرق دفع أخرى. |
acceptsNfc |
يقبل المكان عمليات الدفع عبر NFC. |
ParkingOptions
معلومات حول خيارات ركن السيارة في المكان. يمكن لموقف السيارات دعم أكثر من خيار في نفس الوقت.
تمثيل JSON |
---|
{ "freeParkingLot": boolean, "paidParkingLot": boolean, "freeStreetParking": boolean, "paidStreetParking": boolean, "valetParking": boolean, "freeGarageParking": boolean, "paidGarageParking": boolean } |
الحقول | |
---|---|
freeParkingLot |
يضم المكان مواقف مجانية للسيارات. |
paidParkingLot |
يضم المكان مواقف سيارات برسوم مدفوعة. |
freeStreetParking |
يوفر المكان موقفًا مجانيًا للسيارات في الشارع. |
paidStreetParking |
يضم المكان موقفًا للسيارات برسوم مدفوعة. |
valetParking |
يقدّم المكان خدمة صفّ السيارات من قِبل موظفي الفندق. |
freeGarageParking |
يضم الفندق موقفًا مجانيًا للسيارات في مرآب. |
paidGarageParking |
يضمّ المكان مرآب سيارات برسوم مدفوعة. |
SubDestination
ضع اسم المورد ورقم تعريفه للوجهات الفرعية ذات الصلة بالمكان. على سبيل المثال، تختلف محطات الركّاب باختلاف وجهات المطار.
تمثيل JSON |
---|
{ "name": string, "id": string } |
الحقول | |
---|---|
name |
اسم المورد للوجهة الفرعية. |
id |
رقم تعريف المكان للوجهة الفرعية. |
AccessibilityOptions
تشير هذه السمة إلى معلومات حول خيارات تسهيل الاستخدام التي يقدّمها أحد الأماكن.
تمثيل JSON |
---|
{ "wheelchairAccessibleParking": boolean, "wheelchairAccessibleEntrance": boolean, "wheelchairAccessibleRestroom": boolean, "wheelchairAccessibleSeating": boolean } |
الحقول | |
---|---|
wheelchairAccessibleParking |
يوفر المكان موقفًا للسيارات صالح للكراسي المتحركة. |
wheelchairAccessibleEntrance |
تحتوي الأماكن على مدخل صالح للكراسي المتحركة. |
wheelchairAccessibleRestroom |
يحتوي المكان على دورة مياه صالحة للكراسي المتحركة. |
wheelchairAccessibleSeating |
يضم المكان أماكن جلوس صالحة للكراسي المتحركة. |
FuelOptions
أحدث المعلومات حول خيارات الوقود في محطة وقود يتم تعديل هذه المعلومات بشكل منتظم.
تمثيل JSON |
---|
{
"fuelPrices": [
{
object ( |
الحقول | |
---|---|
fuelPrices[] |
تعرض هذه السمة آخر سعر وقود معروف لكل نوع من أنواع الوقود في هذه المحطة. يتوفّر إدخال واحد لكل نوع وقود في هذه المحطة. الترتيب غير مهم. |
FuelPrice
معلومات عن أسعار الوقود لنوع معيّن
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع الوقود |
price |
سعر الوقود. |
updateTime |
تاريخ آخر تعديل لسعر الوقود طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
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 |
تمثّل هذه السمة رمز العملة المكوَّن من ثلاثة أحرف والمحدّد في ISO 4217. |
units |
تمثّل هذه السمة الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة السمة |
nanos |
عدد وحدات نانو (10^-9) من الكمية. يجب أن تتراوح القيمة بين -999,999,999 و +999,999,999 أو أكثر. إذا كانت قيمة |
EVChargeOptions
معلومات حول محطة شحن المركبة الكهربائية المستضافة في المكان تتبع المصطلحات https://afdc.energy.gov/fuels/electricity_infrastructure.html يمكن أن يشحن منفذ واحد سيارة واحدة في كلّ مرّة. يحتوي منفذ واحد على موصِّل واحد أو أكثر. تتضمن محطة واحدة منفذًا واحدًا أو أكثر.
تمثيل JSON |
---|
{
"connectorCount": integer,
"connectorAggregation": [
{
object ( |
الحقول | |
---|---|
connectorCount |
عدد الموصّلات في هذه المحطة ومع ذلك، نظرًا لأن بعض المنافذ يمكن أن تحتوي على موصلات متعددة ولكنها قادرة فقط على شحن سيارة واحدة في كل مرة (على سبيل المثال)، قد يكون عدد الموصلات أكبر من العدد الإجمالي للسيارات التي يمكنها الشحن في وقت واحد. |
connectorAggregation[] |
قائمة بمجموعات موصِّلات شحن المركبات الكهربائية التي تحتوي على موصِّلات من النوع نفسه ومعدّل الشحن نفسه |
ConnectorAggregation
معلومات شحن المركبات الكهربائية مجمّعة حسب [type, maxChargeRateKw] تعرِض هذه السمة تجميع شحنة المركبات الكهربائية التي تحمل النوع نفسه والحدّ الأقصى لمعدّل الشحن بالكيلوواط.
تمثيل JSON |
---|
{
"type": enum ( |
الحقول | |
---|---|
type |
نوع الموصِّل لهذا التجميع. |
maxChargeRateKw |
يشير ذلك المصطلح إلى الحد الأقصى لمعدّل الشحن الثابت بالكيلوواط لكل موصّل في مجموعة البيانات. |
count |
عدد الموصلات في هذه التجميع. |
availabilityLastUpdateTime |
الطابع الزمني لآخر تعديل لمعلومات مدى توفُّر الموصل في هذه البيانات المجمّعة طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
availableCount |
عدد الموصلات المتاحة حاليًا في هذه الحزمة. |
outOfServiceCount |
عدد الموصلات في هذه الحزمة غير متاحة حاليًا في الخدمة. |
EVConnectorType
يمكنك الانتقال إلى http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 للحصول على سياق إضافي حول أنواع وصلات شحن المركبات الكهربائية.
عمليات التعداد | |
---|---|
EV_CONNECTOR_TYPE_UNSPECIFIED |
موصِّل غير محدَّد. |
EV_CONNECTOR_TYPE_OTHER |
أنواع الموصلات الأخرى. |
EV_CONNECTOR_TYPE_J1772 |
موصل J1772 من النوع 1. |
EV_CONNECTOR_TYPE_TYPE_2 |
موصّل IEC 62196 من النوع 2. وغالبًا ما يُشار إليه باسم MENNEKES. |
EV_CONNECTOR_TYPE_CHADEMO |
موصِّل نوع CHAdeMO |
EV_CONNECTOR_TYPE_CCS_COMBO_1 |
نظام شحن مُجمَّع (AC وDC). استنادًا إلى SAE. وصلة النوع-1 J-1772 |
EV_CONNECTOR_TYPE_CCS_COMBO_2 |
نظام شحن مُجمَّع (AC وDC). استنادًا إلى موصِّل النوع 2 من قناة Mennekes |
EV_CONNECTOR_TYPE_TESLA |
موصل TESLA العام. وهذه المنصة هي نظام NACS في أمريكا الشمالية، ولكن قد لا تكون ضمن معيار NACS في أجزاء أخرى من العالم (على سبيل المثال، CCS Combo 2 (CCS2) أو GB/T). تعتبر هذه القيمة أقل تمثيلاً لنوع الموصل الفعلي، وتمثل بشكل أكبر القدرة على شحن مركبة علامة Tesla التجارية في محطة شحن تملكها Tesla. |
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T |
يتوافق نوع GB/T مع معيار GB/T في الصين. يشمل هذا النوع كل أنواع GB_T. |
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET |
مقبس حائط غير محدَّد |
GenerativeSummary
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.
ملخّص من إنشاء الذكاء الاصطناعي للمكان
تمثيل JSON |
---|
{ "overview": { object ( |
الحقول | |
---|---|
overview |
نظرة عامة على المكان. |
description |
تمثّل هذه السمة الوصف المفصّل للمكان. |
references |
يشير ذلك المصطلح إلى المراجع المستخدَمة لإنشاء وصف الملخّص. |
المراجع
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.
الإشارة إلى المحتوى من إنشاء الذكاء الاصطناعي التوليدي
تمثيل JSON |
---|
{
"reviews": [
{
object ( |
الحقول | |
---|---|
reviews[] |
المراجعات التي يتم استخدامها كمراجع |
places[] |
تمثّل هذه السمة قائمة أسماء الموارد للأماكن المُشار إليها. يمكن استخدام هذا الاسم في واجهات برمجة التطبيقات الأخرى التي تقبل أسماء موارد الأماكن. |
AreaSummary
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.
ملخّص من إنشاء الذكاء الاصطناعي للمنطقة التي يقع فيها المكان
تمثيل JSON |
---|
{
"contentBlocks": [
{
object ( |
الحقول | |
---|---|
contentBlocks[] |
وحدات المحتوى التي تتألف منها ملخّص المنطقة ويكون لكل مبنى موضوع منفصل عن المنطقة. |
ContentBlock
جزء من المحتوى يمكن عرضه بشكل فردي.
تمثيل JSON |
---|
{ "topic": string, "content": { object ( |
الحقول | |
---|---|
topic |
موضوع المحتوى، مثل "نظرة عامة" أو "مطعم". |
content |
المحتوى المرتبط بالموضوع |
references |
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل. المراجع ذات الصلة بكتلة المحتوى هذه |
الطُرق |
|
---|---|
|
لعرض توقعات للإدخال المحدد. |
|
يمكنك الحصول على تفاصيل المكان استنادًا إلى اسم المورد الخاص به، وهو سلسلة بتنسيق places/{place_id} . |
|
البحث عن أماكن بالقرب من المواقع الجغرافية |
|
البحث عن أماكن استنادًا إلى طلب بحث نصي. |