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)
  },
  "consumerAlert": {
    object (ConsumerAlert)
  },
  "movedPlace": string,
  "movedPlaceId": string,
  "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

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

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 )

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

regularOpeningHours

object ( OpeningHours )

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

timeZone

object ( TimeZone )

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

photos[]

object ( Photo )

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

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 )

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

اطلاعات مربوط به گزینه‌های شارژ خودروهای برقی.

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

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

utcOffsetMinutes

integer

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

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

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

متن محلی‌شده

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

نمایش 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 
{
  "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 
{
  "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 موسسه برای همیشه تعطیل است.

سطح قیمت

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

انوم‌ها
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 
{
  "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 نوع 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). مبتنی بر کانکتور نوع ۲ منکس
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 )

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

حاوی مکان

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

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

string

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

id

string

شناسه مکان مکانی که این مکان در آن واقع شده است.

توصیفگر آدرس

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

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

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

روابط فضایی

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

انوم‌ها
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 )

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

مهار

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

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

محدوده قیمت

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

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

object ( Money )

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

endPrice

object ( Money )

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

خلاصه نقد و بررسی

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

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

object ( LocalizedText )

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

flagContentUri

string

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

disclosureText

object ( LocalizedText )

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

reviewsUri

string

پیوندی برای نمایش نظرات مربوط به این مکان در نقشه‌های گوگل.

خلاصه امکانات رفاهی EvCharge

خلاصه‌ای از امکانات رفاهی نزدیک ایستگاه شارژ خودروهای برقی. این مورد فقط برای مکان‌هایی با نوع 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 )

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

بلوک محتوا

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

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

object ( LocalizedText )

مطالب مرتبط با موضوع.

referencedPlaces[]

string

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

خلاصه محله

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

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

object ( ContentBlock )

خلاصه‌ای از وضعیت محله.

description

object ( ContentBlock )

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

flagContentUri

string

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

disclosureText

object ( LocalizedText )

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

هشدار مصرف‌کننده

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

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

string

نمای کلی پیام هشدار به مصرف‌کننده.

details

object ( Details )

جزئیات پیام هشدار به مصرف‌کننده.

languageCode

string

کد زبان پیام هشدار به مصرف‌کننده. این یک کد زبان BCP 47 است.

جزئیات

جزئیات پیام هشدار به مصرف‌کننده.

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

string

عنوانی که به همراه توضیحات نمایش داده می‌شود.

description

string

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

روش‌ها

autocomplete

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

get

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

searchNearby

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

searchText

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