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)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
فیلدها
name

string

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

id

string

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

displayName

object ( LocalizedText )

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

types[]

string

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

primaryType

string

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

primaryTypeDisplayName

object ( LocalizedText )

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

nationalPhoneNumber

string

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

internationalPhoneNumber

string

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

formattedAddress

string

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

shortFormattedAddress

string

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

postalAddress

object ( PostalAddress )

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

addressComponents[]

object ( AddressComponent )

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

plusCode

object ( PlusCode )

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

location

object ( LatLng )

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

viewport

object ( Viewport )

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

rating

number

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

googleMapsUri

string

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

websiteUri

string

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

reviews[]

object ( Review )

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

regularOpeningHours

object ( OpeningHours )

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

timeZone

object ( TimeZone )

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

photos[]

object ( Photo )

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

adrFormatAddress

string

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

businessStatus

enum ( BusinessStatus )

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

priceLevel

enum ( PriceLevel )

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

attributions[]

object ( Attribution )

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

iconMaskBaseUri

string

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

iconBackgroundColor

string

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

currentOpeningHours

object ( OpeningHours )

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

currentSecondaryOpeningHours[]

object ( OpeningHours )

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

regularSecondaryOpeningHours[]

object ( OpeningHours )

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

editorialSummary

object ( LocalizedText )

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

paymentOptions

object ( PaymentOptions )

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

parkingOptions

object ( ParkingOptions )

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

subDestinations[]

object ( SubDestination )

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

fuelOptions

object ( FuelOptions )

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

evChargeOptions

object ( EVChargeOptions )

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

generativeSummary

object ( GenerativeSummary )

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

containingPlaces[]

object ( ContainingPlace )

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

addressDescriptor

object ( AddressDescriptor )

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

priceRange

object ( PriceRange )

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

reviewSummary

object ( ReviewSummary )

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

evChargeAmenitySummary

object ( EvChargeAmenitySummary )

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

neighborhoodSummary

object ( NeighborhoodSummary )

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

consumerAlert

object ( ConsumerAlert )

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

utcOffsetMinutes

integer

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

userRatingCount

integer

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

takeout

boolean

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

delivery

boolean

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

dineIn

boolean

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

curbsidePickup

boolean

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

reservable

boolean

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

servesBreakfast

boolean

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

servesLunch

boolean

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

servesDinner

boolean

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

servesBeer

boolean

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

servesWine

boolean

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

servesBrunch

boolean

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

servesVegetarianFood

boolean

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

outdoorSeating

boolean

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

liveMusic

boolean

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

menuForChildren

boolean

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

servesCocktails

boolean

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

servesDessert

boolean

محل سرو دسر.

servesCoffee

boolean

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

goodForChildren

boolean

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

allowsDogs

boolean

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

restroom

boolean

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

goodForGroups

boolean

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

goodForWatchingSports

boolean

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

accessibilityOptions

object ( AccessibilityOptions )

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

pureServiceAreaBusiness

boolean

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

LocalizedText

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

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

string

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

languageCode

string

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

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

آدرس پستی

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

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

مشاوره در مورد ورود یا ویرایش آدرس:

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

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

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

integer

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

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

regionCode

string

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

languageCode

string

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

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

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

postalCode

string

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

sortingCode

string

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

administrativeArea

string

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

locality

string

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

sublocality

string

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

addressLines[]

string

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

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

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

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

recipients[]

string

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

organization

string

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

Address Component

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

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

string

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

shortText

string

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

types[]

string

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

languageCode

string

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

پلاس کد

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

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

string

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

compoundCode

string

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

LatLng

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

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

number

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

longitude

number

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

درگاه دید

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

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

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

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

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

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

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

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

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

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

object ( LatLng )

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

high

object ( LatLng )

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

بررسی کنید

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

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

string

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

relativePublishTimeDescription

string

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

text

object ( LocalizedText )

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

originalText

object ( LocalizedText )

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

rating

number

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

authorAttribution

object ( AuthorAttribution )

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

publishTime

string ( Timestamp format)

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

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

flagContentUri

string

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

googleMapsUri

string

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

visitDate

object ( Date )

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

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

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

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

string

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

uri

string

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

photoUri

string

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

تاریخ

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

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

انواع مرتبط:

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

integer

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

month

integer

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

day

integer

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

ساعات کار

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

نمایندگی 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 است. تصور نکنید که آنها در همان روز شروع می شوند.

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

secondaryHoursType

enum ( SecondaryHoursType )

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

specialDays[]

object (