REST Resource: places

منبع: مکان

تمام اطلاعات نشان دهنده یک مکان.

نمایندگی JSON
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  }
}
زمینه های
name

string

نام منبع این مکان، در قالب places/{placeId} . می توان از آن برای جستجوی مکان استفاده کرد.

id

string

شناسه منحصر به فرد یک مکان.

displayName

object ( LocalizedText )

نام محلی مکان، مناسب به عنوان یک توصیف کوتاه قابل خواندن برای انسان. مثلاً «گوگل سیدنی»، «استارباکس»، «پیرمانت» و غیره.

types[]

string

مجموعه ای از برچسب های نوع برای این نتیجه. مثلاً «سیاسی» و «محلی». برای فهرست کامل مقادیر ممکن، به جدول A و جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید.

primaryType

string

نوع اولیه نتیجه داده شده. این نوع باید یکی از انواع Places API پشتیبانی شده باشد. مثلاً «رستوران»، «کافه»، «فرودگاه» و ... یک مکان فقط می تواند یک نوع اولیه داشته باشد. برای فهرست کامل مقادیر ممکن، به جدول A و جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید.

primaryTypeDisplayName

object ( LocalizedText )

نام نمایشی نوع اصلی که در صورت وجود به زبان درخواست ترجمه شده است. برای فهرست کامل مقادیر ممکن، به جدول A و جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید.

nationalPhoneNumber

string

یک شماره تلفن قابل خواندن توسط انسان برای مکان، در قالب ملی.

internationalPhoneNumber

string

یک شماره تلفن قابل خواندن توسط انسان برای مکان، در قالب بین المللی.

formattedAddress

string

آدرسی کامل و قابل خواندن برای انسان برای این مکان.

shortFormattedAddress

string

آدرسی کوتاه و قابل خواندن برای انسان برای این مکان.

addressComponents[]

object ( AddressComponent )

اجزای مکرر برای هر سطح محلی. به حقایق زیر در مورد آرایه addressComponents[] توجه کنید: - آرایه اجزای آدرس ممکن است دارای اجزای بیشتری نسبت به فرمت‌شده Address باشد. - این آرایه لزوماً شامل همه نهادهای سیاسی که دارای آدرس هستند، به غیر از آنهایی که در قالب‌بندی شده آدرس هستند، نمی‌شود. برای بازیابی تمام نهادهای سیاسی که حاوی یک آدرس خاص هستند، باید از رمزگذاری جغرافیایی معکوس استفاده کنید و عرض/طول جغرافیایی آدرس را به عنوان پارامتری برای درخواست ارسال کنید. - فرمت پاسخ تضمینی برای ثابت ماندن بین درخواست ها وجود ندارد. به طور خاص، تعداد اجزای آدرس بر اساس آدرس درخواستی متفاوت است و می تواند در طول زمان برای همان آدرس تغییر کند. یک جزء می تواند موقعیت خود را در آرایه تغییر دهد. نوع جزء می تواند تغییر کند. ممکن است یک جزء خاص در پاسخ بعدی گم شده باشد.

plusCode

object ( PlusCode )

کد پلاس مکان مکان lat/long.

location

object ( LatLng )

موقعیت این مکان.

viewport

object ( Viewport )

یک نمای مناسب برای نمایش مکان در یک نقشه با اندازه متوسط.

rating

number

امتیازی بین 1.0 تا 5.0 بر اساس نظرات کاربران از این مکان.

googleMapsUri

string

نشانی اینترنتی که اطلاعات بیشتری درباره این مکان ارائه می‌کند.

websiteUri

string

وب سایت معتبر برای این مکان، به عنوان مثال صفحه اصلی یک کسب و کار. توجه داشته باشید که برای مکان‌هایی که بخشی از یک زنجیره هستند (مثلاً یک فروشگاه IKEA)، این معمولاً وب‌سایت فروشگاه فردی است، نه زنجیره کلی.

reviews[]

object ( Review )

فهرست نظرات درباره این مکان، مرتب شده بر اساس ارتباط. حداکثر 5 نظر را می توان برگرداند.

regularOpeningHours

object ( OpeningHours )

ساعات کار منظم.

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 )

ساعات کار برای هفت روز آینده (از جمله امروز). دوره زمانی از نیمه شب تاریخ درخواست شروع می شود و شش روز بعد در ساعت 23:59 پایان می یابد. این فیلد شامل زیرفیلد specialDays تمام ساعات است که برای تاریخ هایی که ساعات استثنایی دارند تنظیم شده است.

currentSecondaryOpeningHours[]

object ( OpeningHours )

شامل مجموعه ای از ورودی ها برای هفت روز آینده از جمله اطلاعات مربوط به ساعات ثانویه یک کسب و کار. ساعات کار ثانویه با ساعات کاری اصلی یک کسب و کار متفاوت است. به عنوان مثال، یک رستوران می تواند ساعات رانندگی یا ساعت تحویل را به عنوان ساعات فرعی خود مشخص کند. این فیلد زیرفیلد نوع را پر می کند، که از یک لیست از پیش تعریف شده از انواع ساعات کاری (مانند DRIVE_THROUGH، PICKUP، یا TAKEOUT) بر اساس انواع مکان استخراج می شود. این فیلد شامل زیرفیلد specialDays تمام ساعات است که برای تاریخ هایی که ساعات استثنایی دارند تنظیم شده است.

regularSecondaryOpeningHours[]

object ( OpeningHours )

شامل مجموعه‌ای از ورودی‌ها برای اطلاعات مربوط به ساعات کاری عادی یک کسب‌وکار است. ساعات کار ثانویه با ساعات کاری اصلی یک کسب و کار متفاوت است. به عنوان مثال، یک رستوران می تواند ساعات رانندگی یا ساعت تحویل را به عنوان ساعات فرعی خود مشخص کند. این فیلد زیرفیلد نوع را پر می کند، که از یک لیست از پیش تعریف شده از انواع ساعات کاری (مانند DRIVE_THROUGH، PICKUP، یا TAKEOUT) بر اساس انواع مکان استخراج می شود.

editorialSummary

object ( LocalizedText )

شامل خلاصه ای از مکان است. خلاصه از یک نمای کلی متنی تشکیل شده است و در صورت لزوم، کد زبان آن را نیز در بر می گیرد. متن خلاصه باید همانطور که هست ارائه شود و قابل تغییر یا تغییر نیست.

paymentOptions

object ( PaymentOptions )

گزینه های پرداخت محل می پذیرد. اگر داده‌های گزینه پرداخت در دسترس نباشد، قسمت گزینه پرداخت تنظیم نخواهد شد.

parkingOptions

object ( ParkingOptions )

گزینه های پارکینگ ارائه شده توسط مکان.

subDestinations[]

object ( SubDestination )

فهرستی از مقصدهای فرعی مربوط به مکان.

fuelOptions

object ( FuelOptions )

جدیدترین اطلاعات در مورد گزینه های سوخت در پمپ بنزین. این اطلاعات به طور مرتب به روز می شود.

evChargeOptions

object ( EVChargeOptions )

اطلاعات گزینه های شارژ ev.

utcOffsetMinutes

integer

تعداد دقیقه‌هایی که منطقه زمانی این مکان در حال حاضر از UTC خارج شده است. این در دقیقه برای پشتیبانی از مناطق زمانی بیان می‌شود که با کسری از ساعت جبران می‌شوند، به عنوان مثال X ساعت و 15 دقیقه.

userRatingCount

integer

تعداد کل نظرات (با یا بدون متن) برای این مکان.

takeout

boolean

مشخص می‌کند که آیا کسب‌وکار از بیرون‌بر پشتیبانی می‌کند یا خیر.

delivery

boolean

مشخص می کند که آیا کسب و کار از تحویل پشتیبانی می کند یا خیر.

dineIn

boolean

مشخص می‌کند که آیا کسب‌وکار از گزینه‌های صندلی داخلی یا خارجی پشتیبانی می‌کند.

curbsidePickup

boolean

مشخص می‌کند که آیا کسب‌وکار از پیکاپ کناری پشتیبانی می‌کند یا خیر.

reservable

boolean

مشخص می کند که آیا مکان از رزرو پشتیبانی می کند یا خیر.

servesBreakfast

boolean

مشخص می کند که آیا در آن مکان صبحانه سرو می شود.

servesLunch

boolean

مشخص می کند که آیا در آن مکان ناهار سرو می شود یا خیر.

servesDinner

boolean

مشخص می کند که آیا در آن مکان شام سرو می شود.

servesBeer

boolean

مشخص می کند که آیا در آن مکان آبجو سرو می شود.

servesWine

boolean

مشخص می کند که آیا در آن مکان شراب سرو می شود.

servesBrunch

boolean

مشخص می کند که آیا در آن مکان برانچ سرو می شود.

servesVegetarianFood

boolean

مشخص می کند که آیا در آن مکان غذای گیاهی سرو می شود.

outdoorSeating

boolean

مکان صندلی در فضای باز فراهم می کند.

liveMusic

boolean

مکان موسیقی زنده را ارائه می دهد.

menuForChildren

boolean

مکان دارای منوی کودکان است.

servesCocktails

boolean

محل سرو کوکتل است.

servesDessert

boolean

محل سرو دسر.

servesCoffee

boolean

محل سرو قهوه است.

goodForChildren

boolean

مکان برای کودکان خوب است.

allowsDogs

boolean

مکان به سگ ها اجازه می دهد.

restroom

boolean

محل دارای سرویس بهداشتی

goodForGroups

boolean

مکان گروه ها را در خود جای می دهد.

goodForWatchingSports

boolean

مکانی برای تماشای ورزش مناسب است.

accessibilityOptions

object ( AccessibilityOptions )

اطلاعاتی درباره گزینه‌های دسترس‌پذیری که یک مکان ارائه می‌دهد.

LocalizedText

نوع موضعی یک متن در یک زبان خاص.

نمایندگی JSON
{
  "text": string,
  "languageCode": string
}
زمینه های
text

string

رشته محلی شده در زبان مربوط به languageCode زیر.

languageCode

string

کد زبان BCP-47 متن، مانند "en-US" یا "sr-Latn".

برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید.

Address Component

اجزای ساختاری که آدرس فرمت شده را تشکیل می دهند، اگر این اطلاعات در دسترس باشد.

نمایندگی JSON
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
زمینه های
longText

string

شرح متن کامل یا نام جزء آدرس. به عنوان مثال، یک جزء آدرس برای کشور استرالیا ممکن است دارای نام طولانی "Australia" باشد.

shortText

string

یک نام متنی مختصر برای جزء آدرس، در صورت وجود. به عنوان مثال، یک جزء آدرس برای کشور استرالیا ممکن است نام کوتاه "AU" داشته باشد.

types[]

string

آرایه ای که نوع(های) جزء آدرس را نشان می دهد.

languageCode

string

زبان مورد استفاده برای قالب بندی این مؤلفه ها، در نماد CLDR.

پلاس کد

کد پلاس ( http://plus.codes ) یک مرجع مکان با دو قالب است: کد جهانی که مستطیل 14mx14m (1/8000 درجه) یا کوچکتر را تعریف می کند و کد ترکیبی که پیشوند را با یک مکان مرجع جایگزین می کند.

نمایندگی JSON
{
  "globalCode": string,
  "compoundCode": string
}
زمینه های
globalCode

string

کد جهانی (کامل) مکان، مانند "9FWM33GV+HQ"، که یک منطقه 1/8000 در 1/8000 درجه (~14 در 14 متر) را نشان می دهد.

compoundCode

string

کد ترکیبی Place، مانند "33GV+HQ، Ramberg، Norway"، حاوی پسوند کد جهانی و جایگزینی پیشوند با نام قالب بندی شده یک نهاد مرجع.

LatLng

شیئی که نشان دهنده یک جفت طول و عرض جغرافیایی است. این به صورت یک جفت دوتایی برای نشان دادن درجه عرض جغرافیایی و درجه طول جغرافیایی بیان می شود. مگر اینکه طور دیگری مشخص شده باشد، این شی باید با استاندارد WGS84 مطابقت داشته باشد. مقادیر باید در محدوده نرمال شده باشند.

نمایندگی JSON
{
  "latitude": number,
  "longitude": number
}
زمینه های
latitude

number

عرض جغرافیایی بر حسب درجه باید در محدوده [-90.0، +90.0] باشد.

longitude

number

طول جغرافیایی بر حسب درجه باید در محدوده [-180.0، +180.0] باشد.

درگاه دید

یک نمای طول-طول جغرافیایی که به صورت دو نقطه low و high به صورت مورب در مقابل هم نمایش داده می شود. یک viewport یک منطقه بسته در نظر گرفته می شود، یعنی شامل مرز آن می شود. محدوده عرض جغرافیایی باید بین 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, "Litude": -74.259087 }, "high": { "Latitude": 40.91618, "Latitude": -73.70018 } }

نمایندگی JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
زمینه های
low

object ( LatLng )

ضروری. نقطه پایین دید.

high

object ( LatLng )

ضروری. نقطه اوج دید.

مرور

اطلاعاتی در مورد بررسی یک مکان.

نمایندگی JSON
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}
زمینه های
name

string

مرجعی که نمایانگر این بررسی مکان است که ممکن است برای جستجوی مجدد این بررسی مکان مورد استفاده قرار گیرد (که نام «منبع» API نیز نامیده می‌شود: 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" .

اعتبار نویسنده

اطلاعات مربوط به نویسنده داده های UGC. مورد استفاده در Photo و Review .

نمایندگی JSON
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
زمینه های
displayName

string

نام نویسنده Photo یا Review .

uri

string

URI نویسنده Photo یا Review .

photoUri

string

عکس نمایه URI نویسنده Photo یا Review .

ساعات کار

اطلاعات مربوط به ساعت کاری محل

نمایندگی JSON
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}
زمینه های
periods[]

object ( Period )

دوره هایی که این مکان در طول هفته باز است. دوره‌ها به ترتیب زمانی هستند و از یکشنبه در منطقه زمانی مکانی-مکانی شروع می‌شوند. مقدار خالی (اما وجود ندارد) مکانی را نشان می دهد که هرگز باز نیست، به عنوان مثال به این دلیل که به طور موقت برای بازسازی بسته شده است.

weekdayDescriptions[]

string

رشته‌های محلی که ساعات کار این مکان را توصیف می‌کنند، یک رشته برای هر روز هفته. اگر ساعت ها ناشناخته باشند یا نتوان آنها را به متن محلی تبدیل کرد خالی خواهد بود. مثال: "Sun: 18:00-06:00"

secondaryHoursType

enum ( SecondaryHoursType )

رشته ای که برای شناسایی نوع ساعات ثانویه استفاده می شود.

specialDays[]

object ( SpecialDay )

اطلاعات ساختاریافته برای روزهای خاص که در دوره ای است که ساعات بازگردانده شده را پوشش می دهد. روزهای خاص روزهایی هستند که می توانند بر ساعات کاری یک مکان تأثیر بگذارند، مثلاً روز کریسمس. اگر ساعات کاری استثنایی وجود دارد، برای currentOpeningHours و currentSecondaryOpeningHours تنظیم کنید.

openNow

boolean

آیا این مکان در حال حاضر باز است؟ همیشه حاضر است مگر اینکه داده‌های مربوط به زمان یا منطقه زمانی این ساعات کاری را نداشته باشیم.

دوره زمانی

دوره ای که مکان در وضعیت openNow باقی می ماند.

نمایندگی JSON
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
زمینه های
open

object ( Point )

زمانی که مکان شروع به باز شدن می کند.

close

object ( Point )

زمانی که مکان شروع به بسته شدن می کند.

نقطه

نقاط تغییر وضعیت

نمایندگی JSON
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
زمینه های
date

object ( Date )

تاریخ در منطقه زمانی محلی برای مکان.

truncated

boolean

آیا این نقطه پایانی کوتاه شده است یا نه. کوتاهی زمانی اتفاق می‌افتد که ساعات واقعی خارج از زمان‌هایی باشد که ما می‌خواهیم ساعت‌ها بین آن‌ها برگردیم، بنابراین ساعت‌ها را به این مرزها برمی‌گردانیم. این تضمین می کند که حداکثر 24 * 7 ساعت از نیمه شب روز درخواست برگشت داده شود.

day

integer

یک روز از هفته، به عنوان یک عدد صحیح در محدوده 0-6. 0 یکشنبه، 1 دوشنبه و غیره است.

hour

integer

ساعت 2 رقمی محدوده از 00 تا 23.

minute

integer

دقیقه به صورت 2 رقمی محدوده از 00 تا 59.

تاریخ

نمایانگر یک تاریخ تقویم کامل یا جزئی، مانند روز تولد است. زمان روز و منطقه زمانی یا در جای دیگری مشخص شده است یا ناچیز است. تاریخ مربوط به تقویم میلادی است. این می تواند نشان دهنده یکی از موارد زیر باشد:

  • تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر.
  • یک ماه و روز، با یک سال صفر (مثلاً یک سالگرد).
  • یک سال به تنهایی، با یک ماه صفر و یک روز صفر.
  • یک سال و یک ماه، با روز صفر (مثلاً تاریخ انقضای کارت اعتباری).

انواع مرتبط:

نمایندگی JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
زمینه های
year

integer

سال تاریخ. برای تعیین تاریخ بدون سال باید از 1 تا 9999 یا 0 باشد.

month

integer

ماه از یک سال. باید از 1 تا 12 یا 0 باشد تا یک سال بدون ماه و روز مشخص شود.

day

integer

روز یک ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا 0 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد.

SecondaryHoursType

نوعی که برای شناسایی نوع ساعات متوسطه استفاده می شود.

Enums
SECONDARY_HOURS_TYPE_UNSPECIFIED مقدار پیش‌فرض زمانی که نوع ساعت ثانویه مشخص نشده باشد.
DRIVE_THROUGH ساعت رانندگی برای بانک‌ها، رستوران‌ها یا داروخانه‌ها.
HAPPY_HOUR ساعت خوش
DELIVERY ساعت تحویل
TAKEOUT ساعت بیرون بردن
KITCHEN ساعت آشپزخانه
BREAKFAST ساعت صبحانه
LUNCH ساعت ناهار
DINNER ساعت شام
BRUNCH ساعت برانچ
PICKUP ساعت وانت.
ACCESS ساعات دسترسی به مکان های ذخیره سازی
SENIOR_HOURS ساعات کاری ویژه سالمندان
ONLINE_SERVICE_HOURS ساعت خدمات آنلاین

روز خاص

اطلاعات ساختاریافته برای روزهای خاص که در دوره ای است که ساعات بازگردانده شده را پوشش می دهد. روزهای خاص روزهایی هستند که می توانند بر ساعات کاری یک مکان تأثیر بگذارند، مثلاً روز کریسمس.

نمایندگی JSON
{
  "date": {
    object (Date)
  }
}
زمینه های
date

object ( Date )

تاریخ این روز خاص.

عکس

اطلاعات مربوط به عکس یک مکان

نمایندگی JSON
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}
زمینه های
name

string

مشخص کننده. مرجعی که این عکس مکان را نشان می دهد که ممکن است برای جستجوی دوباره این عکس مکان استفاده شود (همچنین نام "منبع" API نیز نامیده می شود: places/{placeId}/photos/{photo} ).

widthPx

integer

حداکثر عرض موجود، بر حسب پیکسل.

heightPx

integer

حداکثر ارتفاع موجود، بر حسب پیکسل.

authorAttributions[]

object ( AuthorAttribution )

نویسندگان این عکس

وضعیت کسب و کار

وضعیت تجاری برای مکان

Enums
BUSINESS_STATUS_UNSPECIFIED مقدار پیش فرض. این مقدار استفاده نشده است.
OPERATIONAL تأسیسات عملیاتی است، لزوماً اکنون باز نیست.
CLOSED_TEMPORARILY موسسه به طور موقت تعطیل است.
CLOSED_PERMANENTLY موسسه برای همیشه تعطیل است.

سطح قیمت

سطح قیمت مکان.

Enums
PRICE_LEVEL_UNSPECIFIED سطح قیمت مکان نامشخص یا ناشناخته است.
PRICE_LEVEL_FREE Place خدمات رایگان ارائه می دهد.
PRICE_LEVEL_INEXPENSIVE Place خدمات ارزان قیمتی را ارائه می دهد.
PRICE_LEVEL_MODERATE Place خدمات با قیمت متوسط ​​ارائه می دهد.
PRICE_LEVEL_EXPENSIVE مکان خدمات گران قیمتی ارائه می دهد.
PRICE_LEVEL_VERY_EXPENSIVE مکان خدمات بسیار گرانی ارائه می دهد.

انتساب

اطلاعاتی درباره ارائه دهندگان داده این مکان.

نمایندگی JSON
{
  "provider": string,
  "providerUri": string
}
زمینه های
provider

string

نام ارائه‌دهنده داده Place.

providerUri

string

URI به ارائه‌دهنده داده Place.

گزینه های پرداخت

گزینه های پرداخت محل می پذیرد.

نمایندگی JSON
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
زمینه های
acceptsCreditCards

boolean

Place کارت های اعتباری را به عنوان پرداخت می پذیرد.

acceptsDebitCards

boolean

Place کارت های نقدی را به عنوان پرداخت می پذیرد.

acceptsCashOnly

boolean

مکان فقط به عنوان پرداخت پول نقد می پذیرد. مکان‌های دارای این ویژگی ممکن است همچنان روش‌های پرداخت دیگری را بپذیرند.

acceptsNfc

boolean

Place پرداخت‌های NFC را می‌پذیرد.

گزینه های پارکینگ

اطلاعات در مورد گزینه های پارکینگ برای مکان. یک پارکینگ می تواند بیش از یک گزینه را به طور همزمان پشتیبانی کند.

نمایندگی 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

مکان دارای پارکینگ گاراژ پولی است.

مقصد فرعی

نام منبع مکان و شناسه مقصدهای فرعی که به مکان مربوط می شود. به عنوان مثال، ترمینال های مختلف مقاصد مختلف یک فرودگاه هستند.

نمایندگی JSON
{
  "name": string,
  "id": string
}
زمینه های
name

string

نام منبع مقصد فرعی.

id

string

شناسه مکان مقصد فرعی.

گزینه های دسترسی

اطلاعاتی درباره گزینه‌های دسترس‌پذیری که یک مکان ارائه می‌دهد.

نمایندگی JSON
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
زمینه های
wheelchairAccessibleParking

boolean

مکان دارای پارکینگ قابل دسترسی برای ویلچر است.

wheelchairAccessibleEntrance

boolean

اماکن دارای ورودی قابل دسترسی با ویلچر است.

wheelchairAccessibleRestroom

boolean

این مکان دارای سرویس بهداشتی قابل دسترسی برای ویلچر است.

wheelchairAccessibleSeating

boolean

مکان دارای صندلی های قابل دسترسی برای ویلچر است.

گزینه های سوخت

جدیدترین اطلاعات در مورد گزینه های سوخت در پمپ بنزین. این اطلاعات به طور مرتب به روز می شود.

نمایندگی JSON
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
زمینه های
fuelPrices[]

object ( 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" .

نوع سوخت

انواع سوخت.

Enums
FUEL_TYPE_UNSPECIFIED نوع سوخت نامشخص
DIESEL سوخت دیزلی.
REGULAR_UNLEADED بدون سرب معمولی
MIDGRADE متوسطه.
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 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" باشد، 1 واحد یک دلار آمریکا است.

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

اطلاعاتی درباره ایستگاه شارژ EV میزبانی شده در Place. اصطلاحات به شرح زیر است https://afdc.energy.gov/fuels/electricity_infrastructure.html یک پورت می تواند هر بار یک خودرو را شارژ کند. یک پورت یک یا چند کانکتور دارد. یک ایستگاه یک یا چند پورت دارد.

نمایندگی JSON
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
زمینه های
connectorCount

integer

تعداد کانکتورها در این ایستگاه با این حال، از آنجایی که برخی از پورت ها می توانند چندین کانکتور داشته باشند اما فقط می توانند یک خودرو را در یک زمان شارژ کنند (مثلاً) تعداد کانکتورها ممکن است بیشتر از تعداد کل ماشین هایی باشد که می توانند همزمان شارژ شوند.

connectorAggregation[]

object ( ConnectorAggregation )

فهرستی از کانکتورهای شارژ EV که حاوی کانکتورهایی با همان نوع و نرخ شارژ یکسان هستند.

ConnectorAggregation

اطلاعات شارژ EV گروه بندی شده بر اساس [نوع، maxChargeRateKw]. تجمع شارژ EV کانکتورهایی را نشان می دهد که نوع و حداکثر نرخ شارژ را بر حسب کیلووات دارند.

نمایندگی 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 مراجعه کنید.

Enums
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). بر اساس کانکتور Type-2 Mennekes
EV_CONNECTOR_TYPE_TESLA کانکتور عمومی TESLA. این NACS در آمریکای شمالی است اما می‌تواند در سایر نقاط جهان غیرNACS باشد (مانند CCS Combo 2 (CCS2) یا GB/T). این مقدار کمتر معرف یک نوع اتصال دهنده واقعی است و بیشتر نشان دهنده توانایی شارژ خودروی برند تسلا در ایستگاه شارژ متعلق به تسلا است.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T نوع GB/T مطابق با استاندارد GB/T در چین است. این نوع همه انواع GB_T را پوشش می دهد.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET پریز دیواری نامشخص

مواد و روش ها

autocomplete

پیش بینی های ورودی داده شده را برمی گرداند.

get

جزئیات یک مکان را بر اساس نام منبع آن، که رشته‌ای در قالب places/{place_id} است، دریافت کنید.

searchNearby

مکان های نزدیک به مکان ها را جستجو کنید.

searchText

جستجوی مکان مبتنی بر پرس و جو متنی.