- المرجع: المكان
- 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. لاسترداد جميع الكيانات السياسية التي تحتوي على عنوان محدّد، عليك استخدام الترميز الجغرافي العكسي، مع تمرير خط العرض/خط الطول للعنوان كمَعلمة للطلب. - لا يمكن ضمان بقاء تنسيق الرد كما هو بين الطلبات. على وجه التحديد، يختلف عدد عناصر addressComponents حسب العنوان المطلوب، ويمكن أن يتغير بمرور الوقت للعنوان نفسه. يمكن للمكون تغيير موضعه في الصفيفة. يمكن أن يتغير نوع المكون. قد يكون هناك مكوِّن غير متوفر في رد لاحق. |
plusCode |
رمز Plus Codes لخط العرض/الطول للموقع. |
location |
تمثّل هذه السمة موضع هذا المكان. |
viewport |
إطار عرض مناسب لعرض المكان على خريطة ذات حجم متوسط. |
rating |
تقييم بين 1.0 و5.0 استنادًا إلى مراجعات المستخدمين لهذا المكان |
googleMapsUri |
عنوان URL يقدّم المزيد من المعلومات عن هذا المكان |
websiteUri |
تمثّل هذه السمة الموقع الإلكتروني الموثوق به لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري. تجدر الإشارة إلى أنّه بالنسبة إلى الأماكن التي تشكّل جزءًا من سلسلة متاجر (مثل متجر IKEA)، سيتمثل ذلك عادةً في الموقع الإلكتروني للمتجر الفردي، وليس السلسلة بأكملها. |
reviews[] |
قائمة بالمراجعات حول هذا المكان، مرتبة حسب مدى صلتها بالموضوع يمكن إرجاع 5 مراجعات كحدّ أقصى. |
regularOpeningHours |
ساعات العمل العادية: |
photos[] |
معلومات (بما في ذلك المراجع) عن صور هذا المكان يمكن عرض 10 صور كحدّ أقصى. |
adrFormatAddress |
عنوان المكان في تنسيق DKIM لـ adr: 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) هو مرجع موقع بتنسيقين: رمز عام يحدد 14MX14m (1/8000 من الدرجة) أو مستطيلاً أصغر حجمًا، ورمزًا مركّبًا، حيث يتم استبدال البادئة بالموقع المرجعي.
تمثيل JSON |
---|
{ "globalCode": string, "compoundCode": string } |
الحقول | |
---|---|
globalCode |
الرمز العالمي للمكان (الكامل)، مثل "9FWM33GV+HQ"، الذي يمثّل مساحة 1/8000 x 1/8000 درجة (حوالي 14 × 14 متر) |
compoundCode |
الرمز المركَّب للمكان، مثل "33GV+HQ، رامبيرغ، النرويج"، الذي يحتوي على لاحقة الرمز العالمي ويستبدل البادئة باسم منسَّق لكيان مرجعي |
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 "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
AuthorAttribution
معلومات حول مؤلف بيانات المحتوى الذي ينشئه المستخدمون مُستخدَمة في Photo
وReview
.
تمثيل JSON |
---|
{ "displayName": string, "uri": string, "photoUri": string } |
الحقول | |
---|---|
displayName |
|
uri |
|
photoUri |
معرّف الموارد المنتظم (URI) لصورة الملف الشخصي لمؤلف |
OpeningHours
معلومات حول ساعة العمل الخاصة بالمكان
تمثيل JSON |
---|
{ "periods": [ { object ( |
الحقول | |
---|---|
periods[] |
الفترات التي يعمل فيها هذا المكان خلال أيام الأسبوع. تظهر الفترات بترتيب زمني، بدءًا من الأحد حسب المنطقة الزمنية المحلية للمكان. تشير القيمة الفارغة (لكن غير موجودة) إلى مكان لا يفتح أبدًا، على سبيل المثال، لأنه مغلق مؤقتًا بسبب أعمال التجديد. |
weekdayDescriptions[] |
سلاسل مترجَمة تصف ساعات العمل لهذا المكان، سلسلة واحدة لكل يوم من الأسبوع. سيتم ترك هذا الحقل فارغًا إذا كانت الساعات غير معروفة أو تعذَّر تحويلها إلى نص مترجَم. مثال: "الأحد: 18:00–06:00" |
secondaryHoursType |
سلسلة type تُستخدم لتحديد نوع ساعات العمل الثانوية. |
specialDays[] |
المعلومات المنظَّمة للأيام الخاصة التي تقع خلال الفترة التي تغطيها ساعات العمل المعروضة. الأيام الخاصة هي الأيام التي قد تؤثّر على ساعات العمل في مكان معيّن، مثل يوم عيد الميلاد. يتم ضبطها على ساعات OpeningHours الحالية و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 "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
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
معلومات عن محطة شحن المركبة الكهربائية التي تستضيفها في Place. تتم إضافة المصطلحات التالية إلى 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 "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
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 |
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} . |
|
البحث عن أماكن بالقرب من المواقع الجغرافية |
|
البحث عن الأماكن استنادًا إلى طلبات البحث النصية |