REST Resource: places

منبع: مکان

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

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

string

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

id

string

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

displayName

object ( LocalizedText )

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

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

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

postalAddress

object ( PostalAddress )

آدرس در قالب آدرس پستی

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 )

ساعات کار منظم. توجه داشته باشید که اگر مکانی همیشه باز باشد (24 ساعت)، قسمت close تنظیم نخواهد شد. مشتریان می توانند به همیشه باز (24 ساعت) اعتماد کنند که به عنوان یک دوره open حاوی day با مقدار 0 ، hour با مقدار 0 و minute با مقدار 0 نمایش داده می شود.

timeZone

object ( TimeZone )

منطقه زمانی پایگاه داده منطقه زمانی IANA. به عنوان مثال "America/New_York".

photos[]

object ( Photo )

اطلاعات (از جمله منابع) در مورد عکس های این مکان. حداکثر 10 عکس قابل بازگرداندن است.

adrFormatAddress

string

آدرس مکان در میکروفرمت adr: http://microformats.org/wiki/adr .

businessStatus

enum ( BusinessStatus )

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

priceLevel

enum ( PriceLevel )

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

attributions[]

object ( Attribution )

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

iconMaskBaseUri

string

یک URL کوتاه شده به یک ماسک نماد. کاربر می تواند با اضافه کردن پسوند نوع به انتها (به عنوان مثال، ".svg" یا ".png") به انواع نمادهای مختلف دسترسی پیدا کند.

iconBackgroundColor

string

رنگ پس زمینه برای icon_mask در فرمت هگز، به عنوان مثال #909CE1.

currentOpeningHours

object ( OpeningHours )

ساعات کار برای هفت روز آینده (از جمله امروز). دوره زمانی از نیمه شب تاریخ درخواست شروع می شود و شش روز بعد در ساعت 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.

generativeSummary

object ( GenerativeSummary )

خلاصه ای از مکان ایجاد شده توسط هوش مصنوعی.

containingPlaces[]

object ( ContainingPlace )

فهرست مکان هایی که مکان فعلی در آنها قرار دارد.

addressDescriptor

object ( AddressDescriptor )

توصیف کننده آدرس مکان. توصیفگرهای آدرس شامل اطلاعات اضافی است که به توصیف یک مکان با استفاده از نشانه‌ها و مناطق کمک می‌کند. پوشش منطقه ای توصیفگر آدرس را در https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage ببینید.

priceRange

object ( PriceRange )

محدوده قیمت مرتبط با یک مکان.

reviewSummary

object ( ReviewSummary )

خلاصه ای از مکان ایجاد شده توسط هوش مصنوعی با استفاده از نظرات کاربران.

evChargeAmenitySummary

object ( EvChargeAmenitySummary )

خلاصه امکانات در نزدیکی ایستگاه شارژ EV.

neighborhoodSummary

object ( NeighborhoodSummary )

خلاصه ای از نقاط دیدنی در نزدیکی مکان.

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 )

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

pureServiceAreaBusiness

boolean

نشان می دهد که آیا این مکان یک کسب و کار منطقه خدماتی خالص است یا خیر. کسب و کار منطقه خدمات خالص کسب و کاری است که مستقیماً از مشتریان بازدید می کند یا به آنها تحویل می دهد اما به مشتریان در آدرس کسب و کار آنها خدمات ارائه نمی دهد. به عنوان مثال، مشاغلی مانند خدمات نظافتی یا لوله کش. این مشاغل ممکن است آدرس فیزیکی یا مکان در Google Maps نداشته باشند.

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

آدرس پستی

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

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

مشاوره در مورد وارد کردن آدرس یا ویرایش: - از یک ویجت آدرس آماده بین المللی مانند https://github.com/google/libaddressinput استفاده کنید. - به کاربران نباید عناصر UI برای ورودی یا ویرایش فیلدها در خارج از کشورهایی که آن فیلد استفاده می شود ارائه شود.

برای راهنمایی بیشتر در مورد نحوه استفاده از این طرح، به https://support.google.com/business/answer/6397478 مراجعه کنید.

نمایندگی JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
فیلدها
revision

integer

بازبینی طرحواره PostalAddress . این باید روی 0 تنظیم شود که آخرین ویرایش است.

همه ویرایش‌های جدید باید با نسخه‌های قبلی سازگار باشند.

regionCode

string

مورد نیاز. کد منطقه CLDR کشور/منطقه آدرس. این هرگز استنباط نمی شود و اطمینان از صحیح بودن مقدار به عهده کاربر است. برای جزئیات به https://cldr.unicode.org/ و https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html مراجعه کنید. مثال: "CH" برای سوئیس.

languageCode

string

اختیاری. کد زبان BCP-47 محتویات این آدرس (در صورت شناخته شدن). این اغلب زبان رابط کاربری فرم ورودی است یا انتظار می‌رود با یکی از زبان‌های مورد استفاده در کشور/منطقه آدرس یا معادل‌های نویسه‌گردانی شده آنها مطابقت داشته باشد. این می‌تواند بر قالب‌بندی در برخی کشورها تأثیر بگذارد، اما برای صحت داده‌ها حیاتی نیست و هرگز بر روی اعتبارسنجی یا سایر عملیات مرتبط با قالب‌بندی تأثیر نمی‌گذارد.

اگر این مقدار مشخص نیست، باید حذف شود (به جای تعیین یک پیش فرض احتمالاً نادرست).

مثال: "zh-Hant"، "ja"، "ja-Latn"، "en".

postalCode

string

اختیاری. کد پستی آدرس همه کشورها از کدهای پستی استفاده نمی‌کنند یا نیاز به وجود کد پستی ندارند، اما در جایی که از آنها استفاده می‌شود، ممکن است اعتبار سنجی اضافی را با سایر بخش‌های آدرس (به عنوان مثال، اعتبارسنجی کد پستی یا ایالتی در ایالات متحده) فعال کنند.

sortingCode

string

اختیاری. کد مرتب‌سازی اضافی، خاص کشور. این در اکثر مناطق استفاده نمی شود. در جایی که از آن استفاده می‌شود، مقدار یا رشته‌ای مانند «CEDEX» است که به صورت اختیاری با یک عدد همراه می‌شود (مثلاً «CEDEX 7»)، یا فقط یک عدد به تنهایی نشان‌دهنده «کد بخش» (جامائیکا)، «نشانگر منطقه تحویل» (مالاوی) یا «نشانگر اداره پست» (ساحل عاج).

administrativeArea

string

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

locality

string

اختیاری. به طور کلی به بخش شهر یا شهر آدرس اشاره دارد. مثال: شهر ایالات متحده، کمون فناوری اطلاعات، شهر پست بریتانیا. در مناطقی از جهان که محلات به خوبی تعریف نشده اند یا به خوبی با این ساختار مطابقت ندارند، locality خالی بگذارید و از addressLines استفاده کنید.

sublocality

string

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

addressLines[]

string

خطوط آدرس بدون ساختار که سطوح پایین یک آدرس را توصیف می کند.

از آنجایی که مقادیر در addressLines اطلاعات نوع ندارند و گاهی اوقات ممکن است حاوی چندین مقدار در یک فیلد واحد باشند (مثلاً "Austin, TX")، واضح بودن ترتیب خطوط مهم است. ترتیب خطوط آدرس باید "سفارش پاکت" برای کشور یا منطقه آدرس باشد. در جاهایی که این می تواند متفاوت باشد (مثلاً ژاپن)، address_language برای صریح کردن آن استفاده می شود (مثلاً "ja" برای سفارش بزرگ به کوچک و "ja-Latn" یا "en" برای کوچک به بزرگ). به این ترتیب می توان مشخص ترین خط یک آدرس را بر اساس زبان انتخاب کرد.

حداقل نمایش ساختاری مجاز یک آدرس شامل یک regionCode با تمام اطلاعات باقی مانده در addressLines است. قالب بندی چنین آدرسی تقریباً بدون کدگذاری جغرافیایی امکان پذیر است، اما هیچ استدلال معنایی در مورد هیچ یک از اجزای آدرس نمی توان تا حداقل تا حدی حل شود.

ایجاد آدرسی که فقط شامل یک regionCode و addressLines باشد و سپس geocoding روش توصیه شده برای رسیدگی به آدرس‌های کاملاً بدون ساختار است (برخلاف حدس زدن اینکه کدام قسمت‌های آدرس باید محلی یا مناطق اداری باشد).

recipients[]

string

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

organization

string

اختیاری. نام سازمان در آدرس.

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

مهر زمانی برای بررسی

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

flagContentUri

string

پیوندی که در آن کاربران می‌توانند مشکلی را در بررسی علامت‌گذاری کنند.

googleMapsUri

string

پیوندی برای نمایش نظر در Google Maps.

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

اطلاعات مربوط به نویسنده داده های 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)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
فیلدها
periods[]

object ( Period )

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

weekdayDescriptions[]

string

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

secondaryHoursType

enum ( SecondaryHoursType )

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

specialDays[]

object ( SpecialDay )

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

nextOpenTime

string ( Timestamp format)

دفعه بعد دوره ساعات کاری فعلی تا 7 روز آینده شروع می شود. این فیلد فقط در صورتی پر می شود که دوره ساعات کاری در زمان ارائه درخواست فعال نباشد.

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

nextCloseTime

string ( Timestamp format)

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

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

openNow

boolean

آیا دوره ساعات کاری در حال حاضر فعال است یا خیر. برای ساعات کاری عادی و ساعات کاری فعلی، این قسمت به معنای باز بودن مکان است یا خیر. برای ساعات کار ثانویه و ساعات کاری ثانویه فعلی، این قسمت به معنای فعال بودن ساعات ثانویه این مکان است.

دوره

دوره ای که مکان در وضعیت 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

ساعت در قالب 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

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

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 )

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

منطقه زمانی

یک منطقه زمانی را از پایگاه داده منطقه زمانی IANA نشان می دهد.

نمایندگی JSON 
{
  "id": string,
  "version": string
}
فیلدها
id

string

منطقه زمانی پایگاه داده منطقه زمانی IANA. به عنوان مثال "America/New_York".

version

string

اختیاری. شماره نسخه پایگاه داده منطقه زمانی IANA. به عنوان مثال "2019a".

عکس

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

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

string

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

widthPx

integer

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

heightPx

integer

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

authorAttributions[]

object ( AuthorAttribution )

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

flagContentUri

string

پیوندی که در آن کاربران می توانند مشکلی را در عکس علامت گذاری کنند.

googleMapsUri

string

پیوندی برای نمایش عکس در Google Maps.

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

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

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)

زمان آخرین به روز رسانی قیمت سوخت

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

نوع سوخت

انواع سوخت.

Enums
FUEL_TYPE_UNSPECIFIED نوع سوخت نامشخص
DIESEL سوخت دیزل.
DIESEL_PLUS گازوئیل به اضافه سوخت.
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 گاز مایع.
E80 E 80.
E85 E 85.
E100 E 100.
METHANE متان
BIO_DIESEL بیو دیزل.
TRUCK_DIESEL دیزل کامیون.

پول

مقداری پول را با نوع ارز آن نشان می دهد.

نمایندگی JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
فیلدها
currencyCode

string

کد ارز سه حرفی تعریف شده در ISO 4217.

units

string ( int64 format)

کل واحدهای مقدار. به عنوان مثال، اگر currencyCode "USD" باشد، 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)

مهر زمانی آخرین به‌روزرسانی اطلاعات در دسترس بودن رابط در این مجموعه.

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

availableCount

integer

تعداد رابط‌های موجود در این مجموعه که در حال حاضر در دسترس هستند.

outOfServiceCount

integer

تعداد رابط‌های موجود در این مجموعه که در حال حاضر از سرویس خارج هستند.

EVConnectorType

http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 برای اطلاعات/مطالب بیشتر در مورد انواع کانکتور شارژ EV مراجعه کنید.

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 پریز دیواری نامشخص
EV_CONNECTOR_TYPE_NACS سیستم شارژ آمریکای شمالی (NACS)، استاندارد شده به عنوان SAE J3400.

خلاصه تولیدی

خلاصه ای از مکان ایجاد شده توسط هوش مصنوعی.

نمایندگی JSON 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
فیلدها
overview

object ( LocalizedText )

نمای کلی مکان.

overviewFlagContentUri

string

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

disclosureText

object ( LocalizedText )

پیام افشای هوش مصنوعی "خلاصه شده با جمینی" (و انواع محلی آن). در صورت وجود، این به زبان مشخص شده در درخواست خواهد بود.

حاوی مکان

اطلاعات مربوط به مکانی که این مکان در آن قرار دارد.

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

فاصله سفر، بر حسب متر، در امتداد شبکه جاده از هدف تا نقطه عطف، اگر مشخص باشد. این مقدار حالت حمل و نقل مانند پیاده روی، رانندگی یا دوچرخه سواری را در نظر نمی گیرد.

رابطه فضایی

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

Enums
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 )

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

مهار

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

Enums
CONTAINMENT_UNSPECIFIED مهار نامشخص است.
WITHIN محل مورد نظر در منطقه منطقه، نزدیک به مرکز است.
OUTSKIRTS محل مورد نظر در منطقه منطقه، نزدیک به لبه است.
NEAR مکان مورد نظر خارج از منطقه است، اما نزدیک است.

محدوده قیمت

محدوده قیمت مرتبط با یک مکان. endPrice می‌تواند تنظیم نشود، که محدوده‌ای را بدون کران بالا نشان می‌دهد (به عنوان مثال "بیش از 100 دلار").

نمایندگی JSON 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
فیلدها
startPrice

object ( Money )

پایان پایین محدوده قیمت (شامل). قیمت باید در این مقدار یا بالاتر باشد.

endPrice

object ( Money )

پایان بالای محدوده قیمت (انحصاری). قیمت باید کمتر از این مقدار باشد.

خلاصه مرور

خلاصه ای از مکان ایجاد شده توسط هوش مصنوعی با استفاده از نظرات کاربران.

نمایندگی JSON 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
فیلدها
text

object ( LocalizedText )

خلاصه نظرات کاربران

flagContentUri

string

پیوندی که در آن کاربران می توانند مشکلی را با خلاصه علامت گذاری کنند.

disclosureText

object ( LocalizedText )

پیام افشای هوش مصنوعی "خلاصه شده با جمینی" (و انواع محلی آن). در صورت وجود، این به زبان مشخص شده در درخواست خواهد بود.

EvChargeAmenitySummary

خلاصه امکانات در نزدیکی ایستگاه شارژ EV. این فقط برای مکان هایی با نوع electric_vehicle_charging_station اعمال می شود. فیلد overview تضمین می شود در حالی که فیلدهای دیگر اختیاری هستند.

نمایندگی JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
فیلدها
overview

object ( ContentBlock )

مروری بر امکانات موجود این تضمینی ارائه می شود.

coffee

object ( ContentBlock )

خلاصه ای از گزینه های قهوه در نزدیکی.

restaurant

object ( ContentBlock )

خلاصه ای از رستوران های اطراف

store

object ( ContentBlock )

خلاصه ای از پمپ بنزین های اطراف.

flagContentUri

string

پیوندی که کاربران می توانند با این خلاصه مشکل را پرچم گذاری کنند.

disclosureText

object ( LocalizedText )

پیام افشای هوش مصنوعی "خلاصه با جمینی" (و انواع بومی آن). این به زبان مشخص شده در درخواست در صورت وجود خواهد بود.

محتوای

بلوک محتوا که می تواند به صورت جداگانه سرو شود.

نمایندگی JSON 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
فیلدها
content

object ( LocalizedText )

محتوای مربوط به موضوع.

referencedPlaces[]

string

لیست نام منابع مکانهای ارجاع شده. این نام را می توان در سایر API ها که نام منابع را می پذیرند استفاده شود.

محله

خلاصه ای از نقاط مورد علاقه در نزدیکی مکان.

نمایندگی JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
فیلدها
overview

object ( ContentBlock )

خلاصه ای از این محله.

description

object ( ContentBlock )

شرح مفصلی از محله.

flagContentUri

string

پیوندی که کاربران می توانند با این خلاصه مشکل را پرچم گذاری کنند.

disclosureText

object ( LocalizedText )

پیام افشای هوش مصنوعی "خلاصه با جمینی" (و انواع بومی آن). این به زبان مشخص شده در درخواست در صورت وجود خواهد بود.

روش ها

autocomplete

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

get

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

searchNearby

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

searchText

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