Place (beta)

محل کلاس

google.maps.places . Place کلاس

با فراخوانی const {Place} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

Place
Place(options)
مولفه های:
Beta findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
مولفه های:
مقدار بازگشتی: Promise <{places: Array < Place >}>
مکان را بر اساس شماره تلفن داده شده جستجو می کند. به دلیل موارد نادری که ممکن است چندین مکان شماره تلفن مشترکی داشته باشند، آرایه‌ای را برمی‌گرداند.
Beta findPlaceFromQuery
findPlaceFromQuery(request)
مولفه های:
  • request : FindPlaceFromQueryRequest درخواستی که شامل پرس و جو متن و فیلدهای درخواستی است.
مقدار بازگشتی: Promise <{places: Array < Place >}>
مکان را بر اساس عبارت متنی داده شده جستجو می کند. به دلیل مواردی که پرس و جو کمی مبهم است و بیش از یک مکان برگردانده می شود، آرایه ای را برمی گرداند. این روش برای جستجوهایی در نظر گرفته نشده است که در آن چندین نتیجه مورد انتظار است.
Beta searchByText
searchByText(request)
مولفه های:
مقدار بازگشتی: Promise <{places: Array < Place >}>
جستجوی مکان مبتنی بر پرس و جو متنی.
addressComponents
نوع: Array < AddressComponent > optional
مجموعه اجزای آدرس برای مکان این مکان. اگر داده آدرس مشخصی وجود ندارد، شی را خالی کنید. اگر داده های آدرس از سرور فراخوانی نشده باشد، undefined .
adrFormatAddress
نوع: string optional
نمایش آدرس مکان در میکروفرمت adr .
attributions
نوع: Array < Attribution > optional
متن انتساب برای این نتیجه مکان نمایش داده شود.
businessStatus
نوع: BusinessStatus optional
وضعیت عملیاتی مکان اگر وضعیت شناخته شده ای وجود نداشته باشد، null . اگر داده های وضعیت از سرور بارگیری نشده باشد، undefined .
displayName
نوع: string optional
نام نمایشی مکان اگر نامی وجود نداشته باشد، null . اگر داده های نام از سرور بارگیری نشده باشد، undefined .
formattedAddress
نوع: string optional
آدرس کامل مکان ها
googleMapsURI
نوع: string optional
URL صفحه رسمی گوگل برای این مکان. این صفحه متعلق به Google است که حاوی بهترین اطلاعات موجود در مورد مکان است.
hasCurbsidePickup
نوع: boolean optional
اینکه آیا مکانی دارای وانت کنار خیابان است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
hasDelivery
نوع: boolean optional
اینکه آیا مکانی تحویل دارد یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
hasDineIn
نوع: boolean optional
اینکه آیا مکانی غذاخوری دارد یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
hasTakeout
نوع: boolean optional
اینکه آیا مکانی دارای بیرون‌بر است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
hasWheelchairAccessibleEntrance
نوع: boolean optional
آیا مکانی دارای ورودی قابل دسترسی با صندلی چرخدار است یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
iconBackgroundColor
نوع: string optional
کد رنگ HEX پیش‌فرض برای دسته مکان.
id
نوع: string
شناسه مکان منحصر به فرد
internationalPhoneNumber
نوع: string optional
شماره تلفن مکان در قالب بین المللی. قالب بین المللی شامل کد کشور است و با علامت مثبت (+) پیشوند است.
isReservable
نوع: boolean optional
اینکه آیا یک مکان قابل رزرو است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
location
نوع: LatLng optional
موقعیت مکان
nationalPhoneNumber
نوع: string optional
شماره تلفن مکان، که بر اساس کنوانسیون منطقه‌ای شماره قالب‌بندی شده است.
openingHours
نوع: OpeningHours optional
photos
نوع: Array < Photo > optional
عکس های این مکان این مجموعه شامل حداکثر ده شیء Photo است.
plusCode
نوع: PlusCode optional
priceLevel
نوع: PriceLevel optional
سطح قیمت مکان. این ویژگی می تواند هر یک از مقادیر زیر را برگرداند
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
نوع: number optional
امتیازی بین 1.0 تا 5.0 بر اساس نظرات کاربران از این مکان.
requestedLanguage
نوع: string optional
زبان درخواستی برای این مکان.
requestedRegion
نوع: string optional
منطقه درخواستی برای این مکان.
reviews
نوع: Array < Review > optional
فهرستی از نظرات برای این مکان.
servesBeer
نوع: boolean optional
این که آیا در مکانی آبجو سرو می شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
servesBreakfast
نوع: boolean optional
این که آیا یک مکان صبحانه سرو می کند. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
servesBrunch
نوع: boolean optional
این که آیا در مکانی برانچ سرو می شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
servesDinner
نوع: boolean optional
اینکه آیا در مکانی شام سرو می شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
servesLunch
نوع: boolean optional
این که آیا یک مکان ناهار سرو می کند. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
servesVegetarianFood
نوع: boolean optional
اینکه آیا در مکانی غذای گیاهی سرو می شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
servesWine
نوع: boolean optional
این که آیا یک مکان شراب سرو می کند. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
svgIconMaskURI
نوع: string optional
URI به منبع ماسک تصویر svg که می تواند برای نشان دادن دسته یک مکان استفاده شود.
types
نوع: Array <string> optional
آرایه‌ای از انواع برای این مکان (برای مثال، ["political", "locality"] یا ["restaurant", "establishment"] ).
userRatingCount
نوع: number optional
تعداد رتبه‌بندی‌های کاربرانی که در Place.rating این مکان مشارکت داشته‌اند.
utcOffsetMinutes
نوع: number optional
انحراف از UTC منطقه زمانی فعلی Place، در دقیقه. به عنوان مثال، ساعت استاندارد شرقی اتریش (GMT+10) در صرفه جویی در روز 11 ساعت جلوتر از UTC است، بنابراین utc_offset_minutes 660 خواهد بود. برای مناطق زمانی پشت UTC، افست منفی است. به عنوان مثال، utc_offset_minutes برای کیپ ورد -60 است.
viewport
نوع: LatLngBounds optional
نمای ترجیحی هنگام نمایش این مکان بر روی نقشه.
websiteURI
نوع: string optional
وب سایت معتبر برای این مکان، مانند صفحه اصلی یک کسب و کار.
Beta fetchFields
fetchFields(options)
مولفه های:
مقدار بازگشتی: Promise <{place: Place }>
Beta getNextOpeningTime
getNextOpeningTime([date])
مولفه های:
  • date : Date optional
مقدار بازگشتی: Promise < Date optional >
تاریخ نشان دهنده OpeningHoursTime بعدی را محاسبه می کند. اگر داده ها برای محاسبه نتیجه کافی نباشد، یا این مکان عملیاتی نباشد، تعریف نشده برمی گردد.
Beta isOpen
isOpen([date])
مولفه های:
  • date : Date optional پیش‌فرض تا کنون.
مقدار بازگشتی: Promise <boolean optional >
بررسی کنید که آیا مکان در تاریخ معین باز است یا خیر. اگر داده های شناخته شده برای مکان برای محاسبه آن کافی نباشد، به عنوان مثال اگر ساعات کاری ثبت نشده باشد، با undefined حل می شود.
toJSON
toJSON()
پارامترها: ندارد
Return Value: یک شی JSON با تمام خصوصیات Place درخواست شده Object .

رابط PlaceOptions

google.maps.places . PlaceOptions رابط google.maps.places . PlaceOptions

گزینه هایی برای ساخت مکان

id
نوع: string
شناسه مکان منحصر به فرد
requestedLanguage optional
نوع: string optional
یک شناسه زبان برای زبانی که جزئیات باید به آن بازگردانده شود. لیست زبان های پشتیبانی شده را ببینید.
requestedRegion optional
نوع: string optional
کد منطقه ای منطقه کاربر. این می‌تواند بر عکس‌هایی که ممکن است بازگردانده شوند و احتمالاً موارد دیگر تأثیر بگذارد. کد منطقه یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") را می پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی").

AddressComponent کلاس

google.maps.places . AddressComponent کلاس

با فراخوانی const {AddressComponent} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

longText
نوع: string optional
متن کامل جزء آدرس.
shortText
نوع: string optional
متن کوتاه و کوتاه جزء آدرس داده شده.
types
نوع: Array <string>
آرایه ای از رشته ها که نوع این جزء آدرس را نشان می دهد. لیستی از انواع معتبر را می توان در اینجا یافت.

کلاس اسناد

google.maps.places . Attribution کلاس google.maps.places . Attribution

با فراخوانی const {Attribution} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

provider
نوع: string optional
متن انتساب برای این نتیجه مکان نمایش داده شود.
providerURI
نوع: string optional

رابط FetchFieldsRequest

google.maps.places . FetchFieldsRequest رابط google.maps.places . FetchFieldsRequest

گزینه‌هایی برای واکشی فیلدهای مکان.

fields
نوع: Array <string>
لیست فیلدهایی که باید واکشی شوند.
sessionToken optional
نوع: AutocompleteSessionToken optional
مرجع منحصر به فرد مورد استفاده برای بسته بندی درخواست جزئیات با یک جلسه تکمیل خودکار.

کلاس OpeningHours

google.maps.places . OpeningHours کلاس google.maps.places . OpeningHours

با فراخوانی const {OpeningHours} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

periods
دوره های افتتاحیه که هر روز هفته را پوشش می دهد، از یکشنبه، به ترتیب زمانی شروع می شود. شامل روزهایی نمی شود که مکان باز نیست.
weekdayDescriptions
نوع: Array <string>
آرایه‌ای از هفت رشته که ساعات کار قالب‌بندی شده را برای هر روز هفته نشان می‌دهد. سرویس مکان‌ها ساعت‌های کاری را به‌طور مناسب برای زبان فعلی قالب‌بندی و بومی‌سازی می‌کند. ترتیب عناصر در این آرایه به زبان بستگی دارد. برخی از زبان ها هفته را از دوشنبه شروع می کنند، در حالی که برخی دیگر از یکشنبه شروع می شوند.

کلاس OpeningHoursPeriod

google.maps.places . OpeningHoursPeriod کلاس google.maps.places . OpeningHoursPeriod

با فراخوانی const {OpeningHoursPeriod} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

close
نوع: OpeningHoursPoint optional
زمان بسته شدن مکان.
open
زمان افتتاحیه برای مکان.

کلاس OpeningHoursPoint

google.maps.places . OpeningHoursPoint کلاس google.maps.places . OpeningHoursPoint

با فراخوانی const {OpeningHoursPoint} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

day
نوع: number
روز هفته، به عنوان یک عدد در محدوده [0، 6]، از یکشنبه شروع می شود. مثلا 2 یعنی سه شنبه.
hour
نوع: number
ساعت OpeningHoursPoint.time به عنوان یک عدد، در محدوده [0، 23]. این در منطقه زمانی Place گزارش خواهد شد.
minute
نوع: number
دقیقه از OpeningHoursPoint.time به عنوان یک عدد، در محدوده [0، 59]. این در منطقه زمانی Place گزارش خواهد شد.

کلاس عکس

google.maps.places . Photo کلاس google.maps.places . Photo

با فراخوانی const {Photo} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

authorAttributions
متن ذکر منبع برای این عکس نمایش داده شود.
heightPx
نوع: number
ارتفاع عکس بر حسب پیکسل
widthPx
نوع: number
عرض عکس بر حسب پیکسل
getURI
getURI([options])
مولفه های:
مقدار بازگشتی: string
URL تصویر مربوط به گزینه های مشخص شده را برمی گرداند.

کلاس AuthorAttribution

google.maps.places . AuthorAttribution کلاس google.maps.places . AuthorAttribution

با فراخوانی const {AuthorAttribution} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

displayName
نوع: string
نام نویسنده برای این نتیجه.
photoURI
نوع: string optional
URI عکس نویسنده برای این نتیجه. این ممکن است همیشه در دسترس نباشد.
uri
نوع: string optional
URI نمایه نویسنده برای این نتیجه.

کلاس پلاس کد

google.maps.places . PlusCode کلاس google.maps.places . PlusCode

با فراخوانی const {PlusCode} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

compoundCode
نوع: string optional
یک کد مثبت با 1/8000 درجه در 1/8000 درجه یک منطقه که در آن چهار نویسه اول (کد منطقه) حذف شده و با یک توضیح محل جایگزین می شود. به عنوان مثال، "9G8F+5W زوریخ، سوئیس".
globalCode
نوع: string optional
یک کد مثبت با 1/8000 درجه در 1/8000 درجه منطقه. به عنوان مثال، "8FVC9G8F+5W".

مرور کلاس

google.maps.places . Review کلاس

با فراخوانی const {Review} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

authorAttribution
نوع: AuthorAttribution optional
داور.
publishTime
نوع: Date optional
rating
نوع: number optional
امتیاز این بررسی، عددی بین 1.0 تا 5.0 (شامل).
relativePublishTimeDescription
نوع: string optional
رشته ای از زمان اخیر قالب بندی شده، که زمان بررسی را نسبت به زمان کنونی به شکلی مناسب برای زبان و کشور بیان می کند. به عنوان مثال "یک ماه پیش"".
text
نوع: string optional
متن یک بررسی.
textLanguageCode
نوع: string optional
یک کد زبان IETF که نشان دهنده زبانی است که این بررسی به آن نوشته شده است. توجه داشته باشید که این کد فقط شامل برچسب زبان اصلی بدون هیچ برچسب ثانویه ای است که کشور یا منطقه را نشان می دهد. به عنوان مثال، تمام نظرات انگلیسی به جای «en-AU» یا «en-UK» با عنوان 'en' ' برچسب گذاری شده اند.

ثابت های سطح قیمت

google.maps.places . PriceLevel ثابت های google.maps.places . PriceLevel

تعداد سطح قیمت برای اشیاء Place.

با فراخوانی const {PriceLevel} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

رابط SearchByTextRequest

google.maps.places . SearchByTextRequest رابط google.maps.places . SearchByTextRequest

درخواست رابط برای Beta Place.searchByText .

fields
نوع: Array <string>
فیلدهایی که باید در پاسخ گنجانده شوند، که برای آن صورت‌حساب دریافت می‌شود . اگر ['ALL'] وارد شود، همه فیلدهای موجود برگردانده می‌شوند و برای آنها صورت‌حساب دریافت می‌شود (این برای استقرار تولید توصیه نمی‌شود). برای فهرستی از فیلدها PlaceResult ببینید. فیلدهای تودرتو را می توان با مسیرهای نقطه مشخص کرد (به عنوان مثال، "geometry.location" ).
includedType optional
نوع: string optional
نوع مکان درخواستی لیست کامل انواع پشتیبانی شده: https://developers.google.com/maps/documentation/places/web-service/place-types . فقط یک نوع شامل پشتیبانی می شود. SearchByTextRequest.useStrictTypeFiltering را ببینید
isOpenNow optional
نوع: boolean optional
پیش فرض: false
برای محدود کردن جستجو به مکان‌هایی که در حال حاضر باز هستند استفاده می‌شود.
language optional
نوع: string optional
جزئیات مکان در صورت وجود با زبان ترجیحی نمایش داده می شود. به‌طور پیش‌فرض به اولویت زبان مرورگر خواهد بود. لیست فعلی زبان های پشتیبانی شده: https://developers.google.com/maps/faq#languagesupport .
locationBias optional
منطقه ای برای جستجو این مکان به عنوان یک سوگیری عمل می کند که به این معنی است که نتایج اطراف مکان داده شده ممکن است برگردانده شوند. نمی‌توان همراه با محدودیت مکان تنظیم کرد.
locationRestriction optional
نوع: LatLngBounds | LatLngBoundsLiteral optional
منطقه ای برای جستجو این مکان به عنوان یک محدودیت عمل می کند که به این معنی است که نتایج خارج از مکان معین بازگردانده نمی شوند. همراه با locationBias قابل تنظیم نیست.
maxResultCount optional
نوع: number optional
حداکثر تعداد نتایج برای بازگشت. باید بین 1 تا 20 باشد.
minRating optional
نوع: number optional
نتایجی را فیلتر کنید که میانگین امتیاز آنها از این حد کمتر است. یک مقدار معتبر باید یک شناور بین 0 و 5 (شامل) در آهنگ 0.5 باشد، یعنی [0، 0.5، 1.0، ...، 5.0] شامل. رتبه ورودی به نزدیکترین 0.5 (سقف) گرد می شود. به عنوان مثال، رتبه 0.6 تمام نتایج با رتبه کمتر از 1.0 را حذف می کند.
priceLevels optional
نوع: Array < PriceLevel > optional
برای محدود کردن جستجو به مکان‌هایی که به‌عنوان سطوح قیمت مشخص علامت‌گذاری شده‌اند استفاده می‌شود. هر ترکیبی از سطوح قیمت را می توان انتخاب کرد. پیش‌فرض در تمام سطوح قیمت.
query optional
نوع: string optional
rankBy optional
نوع: SearchByTextRankBy optional
پیش فرض: SearchByTextRankBy.DISTANCE
نتایج چگونه در پاسخ رتبه بندی خواهند شد.
region optional
نوع: string optional
کد کشور/منطقه یونیکد (CLDR) مکانی که درخواست از آنجا می آید. این پارامتر برای نمایش جزئیات مکان، مانند نام مکان خاص منطقه، در صورت وجود استفاده می شود. این پارامتر می تواند بر نتایج بر اساس قانون قابل اجرا تأثیر بگذارد. برای اطلاعات بیشتر، به https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html مراجعه کنید. توجه داشته باشید که کدهای منطقه 3 رقمی در حال حاضر پشتیبانی نمی شوند.
textQuery optional
نوع: string optional
ضروری. پرس و جو متن برای جستجوی متنی.
useStrictTypeFiltering optional
نوع: boolean optional
پیش فرض: false
برای تنظیم فیلتر نوع دقیق برای SearchByTextRequest.includedType استفاده می شود. اگر روی true تنظیم شود، فقط نتایج از همان نوع برگردانده می شود.

ثابت SearchByTextRankBy

google.maps.places . SearchByTextRankBy ثابت google.maps.places . SearchByTextRankBy

RankBy enum برای SearchByTextRequest.

با فراخوانی const {SearchByTextRankBy} = await google.maps.importLibrary("places") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

DISTANCE نتایج را بر اساس فاصله رتبه بندی می کند.
RELEVANCE نتایج را بر اساس ارتباط رتبه بندی می کند.