REST Resource: places

منبع: مکان

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

نمایش JSON 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "googleMapsTypeLabel": {
    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)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "openingDate": {
    object (Date)
  },
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "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)
  },
  "consumerAlert": {
    object (ConsumerAlert)
  },
  "movedPlace": string,
  "movedPlaceId": string,
  "transitStation": {
    object (TransitStation)
  },
  "entrances": [
    {
      object (Entrance)
    }
  ],
  "navigationPoints": [
    {
      object (NavigationPoint)
    }
  ],
  "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,
  "utcOffsetMinutes": integer,
  "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

مجموعه‌ای از برچسب‌های نوع برای این نتیجه. به عنوان مثال، "political" و "locality". برای لیست کامل مقادیر ممکن، به جدول 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 مراجعه کنید. اگر نوع اصلی مکان از نوع پشتیبانی شده نباشد، ممکن است نوع اصلی وجود نداشته باشد. وقتی یک نوع اصلی وجود دارد، همیشه یکی از انواع موجود در فیلد types است.

primaryTypeDisplayName

object ( LocalizedText )

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

googleMapsTypeLabel

object ( LocalizedText )

برچسب نوع مکان در نقشه‌های گوگل، که در صورت لزوم به زبان درخواست بومی‌سازی شده است، برای مثال، "رستوران"، "کافه"، "فرودگاه" و غیره. برچسب نوع ممکن است با نام نمایشی نوع اصلی متفاوت باشد و ممکن است نوع پشتیبانی شده در جدول انواع مکان API Places نباشد.

nationalPhoneNumber

string

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

internationalPhoneNumber

string

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

formattedAddress

string

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

shortFormattedAddress

string

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

postalAddress

object ( PostalAddress )

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

addressComponents[]

object ( AddressComponent )

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

plusCode

object ( PlusCode )

کد بعلاوه موقعیت مکانی (طول/عرض).

location

object ( LatLng )

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

viewport

object ( Viewport )

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

rating

number

امتیازی بین ۱.۰ تا ۵.۰، بر اساس نظرات کاربران در مورد این مکان.

googleMapsUri

string

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

websiteUri

string

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

reviews[]

object ( Review )

فهرست نظرات درباره این مکان، مرتب شده بر اساس میزان اهمیت. حداکثر ۵ نظر قابل ارسال است.

photos[]

object ( Photo )

اطلاعات (شامل منابع) در مورد عکس‌های این مکان. حداکثر ۱۰ عکس قابل بازگشت است.

adrFormatAddress

string

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

businessStatus

enum ( BusinessStatus )

وضعیت تجاری آن مکان.

openingDate

object ( Date )

تاریخی که این مکان در آینده افتتاح خواهد شد. این فیلد فقط در صورتی پر می‌شود که وضعیت کسب‌وکار FUTURE_OPENING باشد.

priceLevel

enum ( PriceLevel )

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

attributions[]

object ( Attribution )

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

iconMaskBaseUri

string

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

iconBackgroundColor

string

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

currentOpeningHours

object ( OpeningHours )

ساعات کاری برای هفت روز آینده (شامل امروز) شامل هرگونه ساعات کاری ویژه. این بازه زمانی از نیمه‌شب تاریخ درخواست شروع می‌شود و شش روز بعد در ساعت ۱۱:۵۹ شب به پایان می‌رسد. اگر ساعات کاری واقعی خارج از این محدوده باشد، ساعات کاری کوتاه می‌شوند. برای مثال، اگر مکانی از ساعت ۱۰ شب دیروز تا ۶ صبح امروز باز باشد، ساعات کاری به ۱۲ شب امروز تا ۶ صبح امروز کوتاه می‌شوند. این فیلد شامل زیرفیلد «روزهای ویژه» برای همه ساعات کاری است که برای تاریخ‌هایی با ساعات کاری استثنایی تنظیم شده است.

regularOpeningHours

object ( OpeningHours )

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

currentSecondaryOpeningHours[]

object ( OpeningHours )

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

regularSecondaryOpeningHours[]

object ( OpeningHours )

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

timeZone

object ( TimeZone )

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

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 )

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

priceRange

object ( PriceRange )

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

reviewSummary

object ( ReviewSummary )

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

evChargeAmenitySummary

object ( EvChargeAmenitySummary )

خلاصه‌ای از امکانات رفاهی نزدیک ایستگاه شارژ خودروهای برقی.

neighborhoodSummary

object ( NeighborhoodSummary )

خلاصه‌ای از جاذبه‌های گردشگری نزدیک محل مورد نظر.

consumerAlert

object ( ConsumerAlert )

پیام هشدار به مصرف‌کننده برای مکانی که در آن فعالیت بررسی مشکوکی را در یک کسب‌وکار تشخیص می‌دهیم یا کسب‌وکاری که سیاست‌های ما را نقض می‌کند.

movedPlace

string

اگر این مکان به طور دائم بسته شده و به مکان جدیدی منتقل شده باشد، این فیلد شامل نام منبع مکان جدید، با فرمت places/{placeId} است. اگر این مکان چندین بار جابجا شده باشد، این فیلد اولین مکان جابجا شده را نشان می‌دهد. اگر این مکان جابجا نشده باشد، این فیلد پر نخواهد شد.

movedPlaceId

string

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

transitStation

object ( TransitStation )

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

entrances[]

object ( Entrance )

ورودی‌های این مقصد.

navigationPoints[]

object ( NavigationPoint )

نقاط ناوبری برای این مقصد.

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

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

utcOffsetMinutes

integer

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

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

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

متن محلی‌شده

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

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

برای راهنمایی بیشتر در مورد نحوه استفاده از این طرحواره، به آدرس 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 . این باید روی ۰ تنظیم شود، که آخرین ویرایش است.

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

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 اطلاعات نوع ندارند و گاهی اوقات ممکن است شامل چندین مقدار در یک فیلد واحد باشند (به عنوان مثال، "آستین، تگزاس")، مهم است که ترتیب خط مشخص باشد. ترتیب خطوط آدرس باید برای کشور یا منطقه آدرس "ترتیب پاکت" باشد. در مکان‌هایی که این می‌تواند متفاوت باشد (به عنوان مثال، ژاپن)، address_language برای صریح کردن آن استفاده می‌شود (به عنوان مثال، "ja" برای ترتیب بزرگ به کوچک و "ja-Latn" یا "en" برای کوچک به بزرگ). به این ترتیب، می‌توان خاص‌ترین خط یک آدرس را بر اساس زبان انتخاب کرد.

حداقل نمایش ساختاری مجاز یک آدرس شامل یک regionCode با تمام اطلاعات باقی مانده است که در addressLines قرار می‌گیرند. می‌توان چنین آدرسی را بدون geocoding به صورت بسیار تقریبی قالب‌بندی کرد، اما تا زمانی که حداقل تا حدی حل نشود، هیچ استدلال معنایی در مورد هیچ یک از اجزای آدرس نمی‌توان ارائه داد.

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

recipients[]

string

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

organization

string

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

کامپوننت آدرس

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

نمایش JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
فیلدها
longText

string

توضیحات متنی کامل یا نام کامپوننت آدرس. برای مثال، یک کامپوننت آدرس برای کشور استرالیا ممکن است نام طولانی "Australia" داشته باشد.

shortText

string

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

types[]

string

آرایه‌ای که نوع(های) مؤلفه آدرس را نشان می‌دهد.

languageCode

string

زبانی که برای قالب‌بندی این مؤلفه‌ها استفاده می‌شود، با نمادگذاری CLDR.

پلاس‌کد

کد پلاس ( http://plus.codes ) یک مرجع مکان با دو قالب است: کد سراسری که مستطیلی به ابعاد ۱۴ در ۱۴ متر (۱/۸۰۰۰ درجه) یا کوچکتر را تعریف می‌کند، و کد مرکب که پیشوند را با یک مکان مرجع جایگزین می‌کند.

نمایش JSON 
{
  "globalCode": string,
  "compoundCode": string
}
فیلدها
globalCode

string

کد سراسری (کامل) یک مکان، مانند "9FWM33GV+HQ"، که نشان‌دهنده‌ی منطقه‌ای با ابعاد ۱/۸۰۰۰ در ۱/۸۰۰۰ درجه (حدود ۱۴ در ۱۴ متر) است.

compoundCode

string

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

لات‌لنگ

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

نمایش JSON 
{
  "latitude": number,
  "longitude": number
}
فیلدها
latitude

number

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

longitude

number

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

ویوپورت

یک دریچه دید طول و عرض جغرافیایی، که به صورت دو نقطه low و high که به صورت مورب روبروی هم قرار دارند، نمایش داده می‌شود. یک دریچه دید یک منطقه بسته در نظر گرفته می‌شود، یعنی شامل مرز خود است. محدوده‌های عرض جغرافیایی باید بین ۹۰- تا ۹۰ درجه و محدوده‌های طول جغرافیایی باید بین ۱۸۰- تا ۱۸۰ درجه باشند. موارد مختلف عبارتند از:

  • اگر low = high ، نمای دید از آن نقطه واحد تشکیل شده است.

  • اگر low.longitude > high.longitude ، محدوده طول جغرافیایی معکوس می‌شود (صفحه نمایش از خط طول جغرافیایی ۱۸۰ درجه عبور می‌کند).

  • اگر low.longitude = -180 درجه و high.longitude = 180 درجه باشد، صفحه نمایش شامل تمام طول‌های جغرافیایی می‌شود.

  • اگر low.longitude = 180 درجه و high.longitude = -180 درجه باشد، محدوده طول جغرافیایی خالی است.

  • اگر low.latitude > high.latitude ، محدوده عرض جغرافیایی خالی است.

هر دو پارامتر low و high باید پر شوند و کادر نمایش داده شده نمی‌تواند خالی باشد (همانطور که در تعاریف بالا مشخص شده است). یک viewport خالی منجر به خطا خواهد شد.

برای مثال، این نمای کلی، شهر نیویورک را به طور کامل در بر می‌گیرد:

{ "کم": { "عرض جغرافیایی": ۴۰.۴۷۷۳۹۸، "طول جغرافیایی": -۷۴.۲۵۹۰۸۷ }، "زیاد": { "عرض جغرافیایی": ۴۰.۹۱۶۱۸، "طول جغرافیایی": -۷۳.۷۰۰۱۸ } }

نمایش 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,
  "visitDate": {
    object (Date)
  }
}
فیلدها
name

string

مرجعی که نشان‌دهنده‌ی نقد این مکان است و می‌توان از آن برای جستجوی مجدد این نقد مکان استفاده کرد (همچنین به آن نام "منبع" API نیز گفته می‌شود: places/{placeId}/reviews/{review} ).

relativePublishTimeDescription

string

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

text

object ( LocalizedText )

متن بومی‌سازی‌شده‌ی نقد.

originalText

object ( LocalizedText )

متن نقد به زبان اصلی.

rating

number

عددی بین ۱.۰ تا ۵.۰ که به آن تعداد ستاره‌ها نیز می‌گویند.

authorAttribution

object ( AuthorAttribution )

نویسنده‌ی این نقد.

publishTime

string ( Timestamp format)

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

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

flagContentUri

string

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

googleMapsUri

string

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

visitDate

object ( Date )

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

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

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

نمایش JSON 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
فیلدها
displayName

string

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

uri

string

آدرس اینترنتی (URI) نویسنده Photo یا Review .

photoUri

string

آدرس اینترنتی عکس پروفایل نویسنده Photo یا Review .

تاریخ

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

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

انواع مرتبط:

نمایش JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
فیلدها
year

integer

سال تاریخ. باید از ۱ تا ۹۹۹۹ باشد، یا برای مشخص کردن تاریخ بدون سال، ۰ باشد.

month

integer

ماه سال. باید از ۱ تا ۱۲ باشد، یا برای مشخص کردن سال بدون ماه و روز، ۰ باشد.

day

integer

روز ماه. باید از ۱ تا ۳۱ باشد و برای سال و ماه معتبر باشد، یا ۰ برای مشخص کردن یک سال به تنهایی یا یک سال و ماه که روز در آن مهم نیست.

عکس

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

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

لینکی برای نمایش عکس روی نقشه گوگل.

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

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

انوم‌ها
BUSINESS_STATUS_UNSPECIFIED مقدار پیش‌فرض. این مقدار استفاده نشده است.
OPERATIONAL این موسسه در حال فعالیت است، نه لزوماً الان باز است.
CLOSED_TEMPORARILY موسسه موقتاً تعطیل است.
CLOSED_PERMANENTLY موسسه برای همیشه تعطیل است.
FUTURE_OPENING این موسسه در آینده افتتاح خواهد شد.

سطح قیمت

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

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

انتساب

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

نمایش JSON 
{
  "provider": string,
  "providerUri": string
}
فیلدها
provider

string

نام ارائه‌دهنده‌ی داده‌های مکان.

providerUri

string

آدرس اینترنتی (URI) به ارائه دهنده داده مکان.

ساعات کاری

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

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

object ( Period )

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

روز شروع periods ثابت نیست و نباید یکشنبه فرض شود. API روز شروع را بر اساس عوامل مختلفی تعیین می‌کند. به عنوان مثال، برای یک کسب و کار 24 ساعته، اولین دوره ممکن است از روز درخواست شروع شود. برای سایر مشاغل، ممکن است اولین روز هفته‌ای باشد که باز هستند.

نکته: ترتیب آرایه periods مستقل از ترتیب آرایه weekdayDescriptions است. فرض نکنید که آنها از یک روز شروع می‌شوند.

weekdayDescriptions[]

string

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

نکته: ترتیب روزها و شروع هفته توسط زبان و منطقه تعیین می‌شود. ترتیب آرایه periods مستقل از ترتیب آرایه weekdayDescriptions است. فرض نکنید که آنها در همان روز شروع می‌شوند.

اگر ساعات مشخص نباشد یا نتوان آن را به متن محلی تبدیل کرد، خالی خواهد بود. مثال: "یکشنبه: ۱۸:۰۰–۰۶:۰۰"

secondaryHoursType

enum ( SecondaryHoursType )

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

specialDays[]

object ( SpecialDay )

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

nextOpenTime

string ( Timestamp format)

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

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

nextCloseTime

string ( Timestamp format)

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

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

openNow

boolean

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

دوره

دوره‌ای که مکان در وضعیت «اکنون باز است» باقی می‌ماند.

نمایش JSON 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
فیلدها
open

object ( Point )

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

close

object ( Point )

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

نقطه

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

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

object ( Date )

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

truncated

boolean

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

day

integer

یک روز از هفته، به صورت یک عدد صحیح در محدوده ۰ تا ۶. ۰ یعنی یکشنبه، ۱ یعنی دوشنبه و غیره.

hour

integer

ساعت در قالب ۲۴ ساعته. از ۰ تا ۲۳ متغیر است.

minute

integer

دقیقه. از ۰ تا ۵۹ متغیر است.

نوع ساعات ثانویه

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

انوم‌ها
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 
{
  "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

نوع سوخت

انواع سوخت.

انوم‌ها
FUEL_TYPE_UNSPECIFIED نوع سوخت نامشخص
DIESEL سوخت دیزل.
DIESEL_PLUS دیزل به علاوه سوخت.
REGULAR_UNLEADED معمولی بدون سرب.
MIDGRADE میان‌رده.
PREMIUM پریمیوم.
SP91 اس پی ۹۱.
SP91_E10 اس پی ۹۱ ای۱۰.
SP92 اس پی ۹۲.
SP95 اس پی ۹۵.
SP95_E10 SP95 E10.
SP98 اس پی ۹۸.
SP99 اس پی ۹۹.
SP100 اس پی ۱۰۰.
LPG گاز مایع نفتی.
E80 ای ۸۰.
E85 ای ۸۵.
E100 ای ۱۰۰.
METHANE متان
BIO_DIESEL بیودیزل.
TRUCK_DIESEL دیزل کامیون.

پول

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

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

string

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

units

string ( int64 format)

کل واحدهای مبلغ. برای مثال اگر currencyCode برابر با "USD" باشد، هر واحد برابر با یک دلار آمریکا است.

nanos

integer

تعداد نانو (10^-9) واحد از مبلغ. مقدار باید بین -999,999,999 و +999,999,999 باشد. اگر units مثبت باشد، nanos باید مثبت یا صفر باشد. اگر units صفر باشد، nanos می‌تواند مثبت، صفر یا منفی باشد. اگر units منفی باشد، nanos باید منفی یا صفر باشد. به عنوان مثال، -1.75 دلار به صورت units = -1 و nanos = -750,000,000 نمایش داده می‌شود.

گزینه‌های شارژ EV

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

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

integer

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

connectorAggregation[]

object ( ConnectorAggregation )

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

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

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

نمایش JSON 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
فیلدها
type

enum ( EVConnectorType )

نوع کانکتور این تجمیع.

maxChargeRateKw

number

حداکثر نرخ شارژ استاتیک بر حسب کیلووات برای هر کانکتور در تجمیع.

count

integer

تعداد کانکتورها در این تجمیع.

availabilityLastUpdateTime

string ( Timestamp format)

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

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

availableCount

integer

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

outOfServiceCount

integer

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

نوع کانکتور EV

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

انوم‌ها
EV_CONNECTOR_TYPE_UNSPECIFIED کانکتور نامشخص.
EV_CONNECTOR_TYPE_OTHER انواع دیگر کانکتور
EV_CONNECTOR_TYPE_J1772 کانکتور نوع ۱ J1772.
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 type 2 connector. Often referred to as MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO type connector.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Combined Charging System (AC and DC). Based on SAE. Type-1 J-1772 connector
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System (AC and DC). Based on Type-2 Mennekes connector
EV_CONNECTOR_TYPE_TESLA The generic TESLA connector. This is NACS in the North America but can be non-NACS in other parts of the world (eg CCS Combo 2 (CCS2) or GB/T). This value is less representative of an actual connector type, and more represents the ability to charge a Tesla brand vehicle at a Tesla owned charging station.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T type corresponds to the GB/T standard in China. This type covers all GB_T types.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Unspecified wall outlet.
EV_CONNECTOR_TYPE_NACS The North American Charging System (NACS), standardized as SAE J3400.

GenerativeSummary

AI-generated summary of the place.

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

object ( LocalizedText )

The overview of the place.

overviewFlagContentUri

string

A link where users can flag a problem with the overview summary.

disclosureText

object ( LocalizedText )

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

ContainingPlace

Info about the place in which this place is located.

JSON representation 
{
  "name": string,
  "id": string
}
فیلدها
name

string

The resource name of the place in which this place is located.

id

string

The place id of the place in which this place is located.

AddressDescriptor

A relational description of a location. Includes a ranked set of nearby landmarks and precise containing areas and their relationship to the target location.

JSON representation 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
فیلدها
landmarks[]

object ( Landmark )

A ranked list of nearby landmarks. The most recognizable and nearby landmarks are ranked first.

areas[]

object ( Area )

A ranked list of containing or adjacent areas. The most recognizable and precise areas are ranked first.

نقطه عطف

Basic landmark information and the landmark's relationship with the target location.

Landmarks are prominent places that can be used to describe a location.

JSON representation 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
فیلدها
name

string

The landmark's resource name.

placeId

string

The landmark's place id.

displayName

object ( LocalizedText )

The landmark's display name.

types[]

string

A set of type tags for this landmark. For a complete list of possible values, see https://developers.google.com/maps/documentation/places/web-service/place-types .

spatialRelationship

enum ( SpatialRelationship )

Defines the spatial relationship between the target location and the landmark.

straightLineDistanceMeters

number

The straight line distance, in meters, between the center point of the target and the center point of the landmark. In some situations, this value can be longer than travelDistanceMeters .

travelDistanceMeters

number

The travel distance, in meters, along the road network from the target to the landmark, if known. This value does not take into account the mode of transportation, such as walking, driving, or biking.

SpatialRelationship

Defines the spatial relationship between the target location and the landmark.

Enums
NEAR This is the default relationship when nothing more specific below applies.
WITHIN The landmark has a spatial geometry and the target is within its bounds.
BESIDE The target is directly adjacent to the landmark.
ACROSS_THE_ROAD The target is directly opposite the landmark on the other side of the road.
DOWN_THE_ROAD On the same route as the landmark but not besides or across.
AROUND_THE_CORNER Not on the same route as the landmark but a single turn away.
BEHIND Close to the landmark's structure but further away from its street entrances.

مساحت

Area information and the area's relationship with the target location.

Areas includes precise sublocality, neighborhoods, and large compounds that are useful for describing a location.

JSON representation 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
فیلدها
name

string

The area's resource name.

placeId

string

The area's place id.

displayName

object ( LocalizedText )

The area's display name.

containment

enum ( Containment )

Defines the spatial relationship between the target location and the area.

مهار

Defines the spatial relationship between the target location and the area.

Enums
CONTAINMENT_UNSPECIFIED The containment is unspecified.
WITHIN The target location is within the area region, close to the center.
OUTSKIRTS The target location is within the area region, close to the edge.
NEAR The target location is outside the area region, but close by.

PriceRange

The price range associated with a Place. endPrice could be unset, which indicates a range without upper bound (eg "More than $100").

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

object ( Money )

The low end of the price range (inclusive). Price should be at or above this amount.

endPrice

object ( Money )

The high end of the price range (exclusive). Price should be lower than this amount.

ReviewSummary

AI-generated summary of the place using user reviews.

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

object ( LocalizedText )

The summary of user reviews.

flagContentUri

string

A link where users can flag a problem with the summary.

disclosureText

object ( LocalizedText )

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

reviewsUri

string

A link to show reviews of this place on Google Maps.

EvChargeAmenitySummary

The summary of amenities near the EV charging station. This only applies to places with type electric_vehicle_charging_station . The overview field is guaranteed to be provided while the other fields are optional.

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

object ( ContentBlock )

An overview of the available amenities. This is guaranteed to be provided.

coffee

object ( ContentBlock )

A summary of the nearby coffee options.

restaurant

object ( ContentBlock )

A summary of the nearby restaurants.

store

object ( ContentBlock )

A summary of the nearby stores.

flagContentUri

string

A link where users can flag a problem with the summary.

disclosureText

object ( LocalizedText )

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

ContentBlock

A block of content that can be served individually.

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

object ( LocalizedText )

Content related to the topic.

referencedPlaces[]

string

The list of resource names of the referenced places. This name can be used in other APIs that accept Place resource names.

NeighborhoodSummary

A summary of points of interest near the place.

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

object ( ContentBlock )

An overview summary of the neighborhood.

description

object ( ContentBlock )

A detailed description of the neighborhood.

flagContentUri

string

A link where users can flag a problem with the summary.

disclosureText

object ( LocalizedText )

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

ConsumerAlert

The consumer alert message for the place when we detect suspicious review activity on a business or a business violates our policies.

JSON representation 
{
  "overview": string,
  "details": {
    object (Details)
  },
  "languageCode": string
}
فیلدها
overview

string

The overview of the consumer alert message.

details

object ( Details )

The details of the consumer alert message.

languageCode

string

The language code of the consumer alert message. This is a BCP 47 language code.

جزئیات

The details of the consumer alert message.

JSON representation 
{
  "title": string,
  "description": string,
  "aboutLink": {
    object (Link)
  }
}
فیلدها
title

string

The title to show together with the description.

description

string

The description of the consumer alert message.

TransitStation

Represents transit-specific information for a place.

JSON representation 
{
  "displayName": {
    object (LocalizedText)
  },
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "stops": [
    {
      object (TransitStop)
    }
  ]
}
فیلدها
displayName

object ( LocalizedText )

The name of the station in the local language.

agencies[]

object ( TransitAgency )

The transit agencies that serve this station.

stops[]

object ( TransitStop )

Transit stops at this station.

TransitAgency

Represents a transit agency.

JSON representation 
{
  "displayName": {
    object (LocalizedText)
  },
  "url": string,
  "fareUrl": string,
  "icon": {
    object (TransitIcon)
  },
  "lines": [
    {
      object (TransitLine)
    }
  ]
}
فیلدها
displayName

object ( LocalizedText )

Agency name (eg "VTA") in the requested language.

url

string

The URL of the agency's homepage.

fareUrl

string

The URL of the agency's fare details page.

icon

object ( TransitIcon )

Icon identifier for localized branded icon of a transit system (eg London Underground) which should be used instead of TransitLine.vehicle_icon in the UI.

lines[]

object ( TransitLine )

The transit lines that are served by this agency.

TransitIcon

Icon for a transit line, vehicle, or agency.

JSON representation 
{
  "url": string,
  "nameIncluded": boolean
}
فیلدها
url

string

The URL of the icon.

nameIncluded

boolean

Whether the name is contained in the icon and there is no need to display it next to the icon.

TransitLine

Represents a single transit line.

JSON representation 
{
  "id": string,
  "vehicleType": enum (VehicleType),
  "displayName": {
    object (LocalizedText)
  },
  "shortDisplayName": {
    object (LocalizedText)
  },
  "textColor": string,
  "backgroundColor": string,
  "url": string,
  "icon": {
    object (TransitIcon)
  },
  "vehicleIcon": {
    object (TransitIcon)
  }
}
فیلدها
id

string

The id of the transit line that can be used to uniquely identify the line among other transit lines in the same transit station. This identifier is not guaranteed to be stable across different responses.

vehicleType

enum ( VehicleType )

The type of vehicle using this line.

displayName

object ( LocalizedText )

The long name for this transit line (eg "Sunnydale local").

shortDisplayName

object ( LocalizedText )

The short name for this transit line (eg "S2").

textColor

string

The text color of labels for this transit line in #RRGGBB hex format, eg #909CE1.

backgroundColor

string

The background color of the labels for this transit line in #RRGGBB hex format, eg #909CE1. This color can also be used for drawing shapes for this transit line.

url

string

The URL of a webpage with details about this line.

icon

object ( TransitIcon )

Icon identifier for this particular line (eg subway lines in New York).

vehicleIcon

object ( TransitIcon )

Icon identifier for this particular vehicle type.

VehicleType

The type of vehicle for a transit line.

Enums
VEHICLE_TYPE_UNSPECIFIED Default value when vehicle type is not specified.
RAIL ریل
METRO_RAIL Metro rail.
SUBWAY مترو.
TRAM تراموا.
MONORAIL Monorail.
HEAVY_RAIL Heavy rail.
COMMUTER_TRAIN Commuter train.
HIGH_SPEED_TRAIN High speed train.
LONG_DISTANCE_TRAIN Long distance train.
BUS اتوبوس.
INTERCITY_BUS Intercity bus.
TROLLEYBUS Trolleybus.
SHARE_TAXI Share taxi.
COACH مربی
FERRY Ferry.
CABLE_CAR Cable car.
GONDOLA_LIFT Gondola lift.
FUNICULAR Funicular.
SPECIAL ویژه.
HORSE_CARRIAGE Horse carriage.
AIRPLANE هواپیما.

TransitStop

Represents a transit stop within a station. This is a specific location where passengers board and alight transit vehicles, such as a platform or bus bay. This is distinct from a Departure , which is an event of a vehicle leaving a stop at a specific time.

JSON representation 
{
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "platformCode": {
    object (LocalizedText)
  },
  "signageText": {
    object (LocalizedText)
  },
  "stopCode": {
    object (LocalizedText)
  },
  "location": {
    object (LatLng)
  },
  "wheelchairAccessibleEntrance": boolean
}
فیلدها
id

string

The id of the transit stop that can be used to uniquely identify the stop among other transit stops in the same transit station. This identifier is not guaranteed to be stable across different responses.

displayName

object ( LocalizedText )

The name of the stop.

platformCode

object ( LocalizedText )

The platform code represented by this stop. It can be formatted in any way. (eg: "2", "Platform 2", "2-4", or "1x").

signageText

object ( LocalizedText )

The verbatim text written on the signboard for this platform, eg "Towards Central" or "East side & Brooklyn". When platformCode is absent, this field is potentially the only identifier for the platform; however, both platformCode and signageText may be set simultaneously.

stopCode

object ( LocalizedText )

Human readable identifier of the stop, used by transit agencies to distinguish stops with the same name.

location

object ( LatLng )

The stop's location.

wheelchairAccessibleEntrance

boolean

Wheelchair accessibility of this stop. This field indicates whether there is an accessible path from outside the station to the stop. It does not indicate whether it is possible to board a vehicle from the stop.

Entrance

An entrance is a single latitude/longitude coordinate pair that defines the location of an entry and exit point for a place.

JSON representation 
{
  "location": {
    object (LatLng)
  },
  "tags": [
    enum (Tag)
  ]
}
فیلدها
location

object ( LatLng )

The location of the entrance.

tags[]

enum ( Tag )

A list of tags that describe the entrance.

برچسب

Characteristics that describe an entrance.

Enums
TAG_UNSPECIFIED استفاده نشده.
PREFERRED

The entrance likely provides physical access to the primary place in the returned destination. A place can have multiple preferred entrances. If an entrance does not have this tag, it means the entrance is physically on the same building as the primary place, but does not necessarily provide access to the place.

For example, if the primary place is a restaurant in a strip mall, the "PREFERRED" entrances will be the ones that likely lead into the restaurant itself, while the other returned entrances will be other entrances for the building, such as entrances into other restaurants in the strip mall.

If the primary place is a building itself, the PREFERRED entrances will be the ones that lead into the "main" part of the building. For example, in a shopping center the PREFERRED entrances will be the ones that allow access to the main foyer area, but if an entrance only provides access to a store on the side of the building, it won't be a PREFERRED entrance.

Note: a PREFERRED entrance might not provide access to the primary place, and a non- PREFERRED entrance might provide access to the primary place.

TravelMode

Travel modes that are appropriate for this navigation point.

Enums
TRAVEL_MODE_UNSPECIFIED استفاده نشده.
DRIVE Suitable for driving.
WALK Suitable for walking.

کاربرد

Usages supported by this navigation point. New values may be added in the future.

Enums
USAGE_UNSPECIFIED استفاده نشده.
DROPOFF Suitable for dropping off a passenger. For example, a rideshare drop off location.
PICKUP Suitable for picking up a passenger. For example, a rideshare pick up location.
PARKING Suitable for parking. For example, within a parking lot.

روش‌ها

autocomplete

 Returns predictions for the given input.

get

 Get the details of a place based on its resource name, which is a string in the places/{place_id} format.

searchNearby

 Search for places near locations.

searchText

 Text query based place search.