REST Resource: places

منبع: مکان

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

نمایندگی JSON 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "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

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

display Name

object ( LocalizedText )

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

types[]

string

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

primary Type

string

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

primary Type Display Name

object ( LocalizedText )

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

national Phone Number

string

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

international Phone Number

string

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

formatted Address

string

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

short Formatted Address

string

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

address Components[]

object ( AddressComponent )

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

plus Code

object ( PlusCode )

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

location

object ( LatLng )

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

viewport

object ( Viewport )

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

rating

number

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

google Maps Uri

string

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

website Uri

string

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

reviews[]

object ( Review )

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

regular Opening Hours

object ( OpeningHours )

ساعات کار منظم. توجه داشته باشید که اگر مکانی همیشه باز باشد (24 ساعت)، قسمت close تنظیم نخواهد شد. مشتریان می‌توانند به این موضوع اعتماد کنند که همیشه باز (24 ساعت) به‌عنوان یک دوره [open][google.foo.OpeningHours.Period.open] حاوی [day][google.foo.Point.day] با مقدار 0 , [hour][] نشان داده شود. google.foo.Point.hour] با مقدار 0 و [minute][google.foo.Point.minute] با مقدار 0 .

photos[]

object ( Photo )

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

adr Format Address

string

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

business Status

enum ( BusinessStatus )

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

price Level

enum ( PriceLevel )

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

attributions[]

object ( Attribution )

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

icon Mask Base Uri

string

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

icon Background Color

string

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

current Opening Hours

object ( OpeningHours )

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

current Secondary Opening Hours[]

object ( OpeningHours )

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

regular Secondary Opening Hours[]

object ( OpeningHours )

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

editorial Summary

object ( LocalizedText )

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

payment Options

object ( PaymentOptions )

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

parking Options

object ( ParkingOptions )

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

sub Destinations[]

object ( SubDestination )

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

fuel Options

object ( FuelOptions )

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

ev Charge Options

object ( EVChargeOptions )

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

generative Summary

object ( GenerativeSummary )

آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.

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

area Summary

object ( AreaSummary )

آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.

خلاصه ای از منطقه ای که مکان در آن ایجاد شده است.

containing Places[]

object ( ContainingPlace )

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

address Descriptor

object ( AddressDescriptor )

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

price Range

object ( PriceRange )

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

utc Offset Minutes

integer

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

user Rating Count

integer

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

takeout

boolean

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

delivery

boolean

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

dine In

boolean

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

curbside Pickup

boolean

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

reservable

boolean

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

serves Breakfast

boolean

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

serves Lunch

boolean

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

serves Dinner

boolean

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

serves Beer

boolean

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

serves Wine

boolean

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

serves Brunch

boolean

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

serves Vegetarian Food

boolean

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

outdoor Seating

boolean

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

live Music

boolean

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

menu For Children

boolean

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

serves Cocktails

boolean

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

serves Dessert

boolean

محل سرو دسر.

serves Coffee

boolean

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

good For Children

boolean

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

allows Dogs

boolean

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

restroom

boolean

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

good For Groups

boolean

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

good For Watching Sports

boolean

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

accessibility Options

object ( AccessibilityOptions )

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

pure Service Area Business

boolean

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

LocalizedText

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

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

string

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

language Code

string

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

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

Address Component

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

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

string

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

short Text

string

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

types[]

string

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

language Code

string

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

پلاس کد

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

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

string

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

compound Code

string

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

LatLng

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

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

number

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

longitude

number

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

درگاه دید

یک نمای طول و عرض جغرافیایی که به صورت دو نقطه low و high به صورت مورب در مقابل هم نمایش داده می شود. یک viewport یک منطقه بسته در نظر گرفته می شود، یعنی شامل مرز آن می شود. محدوده عرض جغرافیایی باید بین 90- تا 90 درجه باشد و محدوده طول جغرافیایی باید بین 180- تا 180 درجه باشد. موارد مختلف عبارتند از:

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

  • اگر low.longitude > high.longitude , محدوده طول معکوس می شود (نمایش از خط طول جغرافیایی 180 درجه عبور می کند).

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

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

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

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

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

{ "low": { "Latitude": 40.477398, "Litude": -74.259087 }, "high": { "Latitude": 40.91618, "Latitude": -73.70018 } }

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

object ( LatLng )

مورد نیاز. نقطه پایین دید.

high

object ( LatLng )

مورد نیاز. نقطه اوج دید.

مرور کنید

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

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

string

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

relative Publish Time Description

string

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

text

object ( LocalizedText )

متن بومی شده بررسی.

original Text

object ( LocalizedText )

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

rating

number

عددی بین 1.0 تا 5.0 که به آن تعداد ستاره نیز می گویند.

author Attribution

object ( AuthorAttribution )

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

publish Time

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

flag Content Uri

string

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

google Maps Uri

string

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

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

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

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

string

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

uri

string

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

photo Uri

string

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

ساعات کار

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

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

object ( Period )

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

weekday Descriptions[]

string

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

secondary Hours Type

enum ( SecondaryHoursType )

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

special Days[]

object ( SpecialDay )

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

next Open Time

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

next Close Time

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

open Now

boolean

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

دوره

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

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

object ( Point )

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

close

object ( Point )

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

نقطه

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

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

object ( Date )

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

truncated

boolean

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

day

integer

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

hour

integer

ساعت در قالب 24 ساعته. محدوده از 0 تا 23.

minute

integer

دقیقه محدوده از 0 تا 59.

تاریخ

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

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

انواع مرتبط:

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

integer

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

month

integer

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

day

integer

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

SecondaryHoursType

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

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

روز ویژه

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

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

object ( Date )

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

عکس

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

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

string

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

width Px

integer

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

height Px

integer

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

author Attributions[]

object ( AuthorAttribution )

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

flag Content Uri

string

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

google Maps Uri

string

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

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

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

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

سطح قیمت

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

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

انتساب

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

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

string

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

provider Uri

string

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

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

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

نمایندگی JSON 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
فیلدها
accepts Credit Cards

boolean

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

accepts Debit Cards

boolean

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

accepts Cash Only

boolean

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

accepts Nfc

boolean

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

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

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

نمایندگی JSON 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
فیلدها
free Parking Lot

boolean

مکان پارکینگ رایگان ارائه می دهد.

paid Parking Lot

boolean

مکان پارکینگ های پولی ارائه می دهد.

free Street Parking

boolean

مکان پارکینگ خیابانی رایگان ارائه می دهد.

paid Street Parking

boolean

مکان پارکینگ خیابانی پولی ارائه می دهد.

valet Parking

boolean

محل ارائه می دهد پارکینگ خدمتکار.

free Garage Parking

boolean

مکان پارکینگ گاراژ رایگان ارائه می دهد.

paid Garage Parking

boolean

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

مقصد فرعی

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

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

string

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

id

string

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

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

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

نمایندگی JSON 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
فیلدها
wheelchair Accessible Parking

boolean

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

wheelchair Accessible Entrance

boolean

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

wheelchair Accessible Restroom

boolean

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

wheelchair Accessible Seating

boolean

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

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

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

نمایندگی JSON 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
فیلدها
fuel Prices[]

object ( FuelPrice )

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

قیمت سوخت

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

نمایندگی JSON 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
فیلدها
type

enum ( FuelType )

نوع سوخت.

price

object ( Money )

قیمت سوخت.

update Time

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

نوع سوخت

انواع سوخت.

Enums
FUEL_TYPE_UNSPECIFIED نوع سوخت نامشخص
DIESEL سوخت دیزل.
REGULAR_UNLEADED بدون سرب معمولی
MIDGRADE متوسطه.
PREMIUM حق بیمه.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG LPG.
E80 E 80.
E85 E 85.
METHANE متان
BIO_DIESEL بیو دیزل.
TRUCK_DIESEL دیزل کامیون.

پول

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

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

string

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

units

string ( int64 format)

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

nanos

integer

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

EVChargeOptions

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

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

integer

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

connector Aggregation[]

object ( ConnectorAggregation )

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

ConnectorAggregation

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

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

enum ( EVConnectorType )

نوع رابط این تجمع.

max Charge Rate Kw

number

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

count

integer

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

availability Last Update Time

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

available Count

integer

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

out Of Service Count

integer

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

EVConnectorType

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

Enums
EV_CONNECTOR_TYPE_UNSPECIFIED کانکتور نامشخص
EV_CONNECTOR_TYPE_OTHER سایر انواع کانکتور
EV_CONNECTOR_TYPE_J1772 کانکتور J1772 نوع 1.
EV_CONNECTOR_TYPE_TYPE_2 کانکتور IEC 62196 نوع 2. اغلب به عنوان MENNEKES شناخته می شود.
EV_CONNECTOR_TYPE_CHADEMO کانکتور نوع CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 سیستم شارژ ترکیبی (AC و DC). بر اساس SAE. کانکتور نوع 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 سیستم شارژ ترکیبی (AC و DC). بر اساس کانکتور Type-2 Mennekes
EV_CONNECTOR_TYPE_TESLA کانکتور عمومی TESLA. این NACS در آمریکای شمالی است اما می‌تواند در سایر نقاط جهان غیرNACS باشد (مانند CCS Combo 2 (CCS2) یا GB/T). این مقدار کمتر معرف یک نوع اتصال دهنده واقعی است و بیشتر نشان دهنده توانایی شارژ خودروی برند تسلا در ایستگاه شارژ متعلق به تسلا است.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T نوع GB/T مطابق با استاندارد GB/T در چین است. این نوع همه انواع GB_T را پوشش می دهد.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET پریز دیواری نامشخص

خلاصه تولیدی

آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.

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

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

object ( LocalizedText )

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

overview Flag Content Uri

string

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

description

object ( LocalizedText )

شرح دقیق مکان.

description Flag Content Uri

string

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

references

object ( References )

مراجعی که برای تولید شرح خلاصه استفاده می شود.

مراجع

آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.

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

نمایندگی JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
فیلدها
reviews[]

object ( Review )

بررسی هایی که به عنوان مرجع عمل می کنند.

places[]

string

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

خلاصه منطقه

آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.

خلاصه ای از منطقه ای که مکان در آن ایجاد شده است.

نمایندگی JSON 
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ],
  "flagContentUri": string
}
فیلدها
content Blocks[]

object ( ContentBlock )

بلوک های محتوایی که خلاصه منطقه را تشکیل می دهند. هر بلوک یک موضوع جداگانه در مورد منطقه دارد.

flag Content Uri

string

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

ContentBlock

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

نمایندگی JSON 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
فیلدها
topic

string

موضوع محتوا، به عنوان مثال "نمای کلی" یا "رستوران".

content

object ( LocalizedText )

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

references

object ( References )

آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.

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

حاوی مکان

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

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

string

نام منبع مکانی که این مکان در آن قرار دارد.

id

string

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

AddressDescriptor

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

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

object ( Landmark )

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

areas[]

object ( Area )

فهرست رتبه بندی شده از مناطق حاوی یا مجاور. قابل تشخیص ترین و دقیق ترین مناطق در رتبه اول قرار می گیرند.

نقطه عطف

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

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

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

string

نام منبع نقطه عطف

place Id

string

شناسه مکان دیدنی

display Name

object ( LocalizedText )

نام نمایشی نقطه عطف

types[]

string

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

spatial Relationship

enum ( SpatialRelationship )

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

straight Line Distance Meters

number

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

travel Distance Meters

number

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

رابطه فضایی

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

Enums
NEAR این رابطه پیش‌فرض زمانی است که هیچ چیز خاص‌تری در زیر اعمال نمی‌شود.
WITHIN این نقطه عطف دارای هندسه فضایی است و هدف در محدوده آن است.
BESIDE هدف مستقیماً در مجاورت نقطه عطف قرار دارد.
ACROSS_THE_ROAD هدف دقیقاً در مقابل نقطه عطفی در طرف دیگر جاده قرار دارد.
DOWN_THE_ROAD در همان مسیری که نقطه عطف است، اما نه در کنار یا آنطرف.
AROUND_THE_CORNER نه در همان مسیر با نقطه عطف، بلکه یک پیچ دورتر.
BEHIND نزدیک به ساختار نقطه عطفی اما دورتر از ورودی های خیابان آن.

منطقه

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

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

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

string

نام منبع منطقه

place Id

string

شناسه مکان منطقه

display Name

object ( LocalizedText )

نام نمایشی منطقه

containment

enum ( Containment )

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

مهار

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

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

محدوده قیمت

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

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

object ( Money )

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

end Price

object ( Money )

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

روش ها

autocomplete

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

get

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

search Nearby

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

search Text

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