Places Service (deprecated)

کلاس PlacesService

‫google.maps.places.PlacesService کلاس

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

با تماس با const {PlacesService} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
PlacesService
PlacesService(attrContainer)
پارامترها: 
نمونه جدیدی از PlacesService ایجاد می‌کند که ارجاع‌ها را در ظرف مشخص‌شده ارائه می‌کند.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
پارامترها: 
مقدار برگشتی:  هیچ
فهرستی از مکان‌ها را براساس شماره تلفن بازیابی می‌کند. در بیشتر موارد، فقط یک مورد باید در فهرست نتایج وجود داشته باشد، اما اگر درخواست مبهم باشد، ممکن است بیش‌از یک نتیجه برگردانده شود. ‫PlaceResultهای گذرانده‌شده به callback زیرمجموعه‌های PlaceResult کامل هستند. برنامه شما می‌تواند با فراخوانی PlacesService.getDetails و ارسال PlaceResult.place_id برای مکان موردنظر، PlaceResult دقیق‌تری برای هر مکان دریافت کند.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
پارامترها: 
مقدار برگشتی:  هیچ
فهرستی از مکان‌ها را براساس رشته پُرسمان بازیابی می‌کند. در بیشتر موارد، فقط یک مورد باید در فهرست نتایج وجود داشته باشد، اما اگر درخواست مبهم باشد، ممکن است بیش‌از یک نتیجه برگردانده شود. ‫PlaceResultهای گذرانده‌شده به callback زیرمجموعه‌های PlaceResult کامل هستند. برنامه شما می‌تواند با فراخوانی PlacesService.getDetails و ارسال PlaceResult.place_id برای مکان موردنظر، PlaceResult دقیق‌تری برای هر مکان دریافت کند.
getDetails
getDetails(request, callback)
پارامترها: 
مقدار برگشتی:  هیچ
جزئیات مربوط به مکان شناسایی‌شده با placeId داده‌شده را بازیابی می‌کند.
nearbySearch
nearbySearch(request, callback)
پارامترها: 
مقدار برگشتی:  هیچ
فهرستی از مکان‌های نزدیک به یک موقعیت خاص را براساس کلیدواژه یا نوع بازیابی می‌کند. مکان همیشه باید مشخص شود، یا با ارسال LatLngBounds، یا پارامترهای location و radius. ‫PlaceResultهای گذرانده‌شده به callback زیرمجموعه‌های PlaceResult کامل هستند. برنامه شما می‌تواند با ارسال درخواست «جزئیات جا» و ارسال PlaceResult.place_id برای جای موردنظر، PlaceResult دقیق‌تری برای هر جا دریافت کند. از شیء PlaceSearchPagination می‌توان برای واکشی صفحه‌های اضافی نتایج استفاده کرد (اگر این آخرین صفحه نتایج باشد یا فقط یک صفحه نتایج وجود داشته باشد، مقدار آن تهی است).
textSearch
textSearch(request, callback)
پارامترها: 
مقدار برگشتی:  هیچ
فهرستی از مکان‌ها را براساس رشته پُرسمان (برای مثال، «پیتزا در نیویورک» یا «کفش‌فروشی‌های نزدیک اتاوا») بازیابی می‌کند. پارامترهای مکان اختیاری هستند؛ وقتی مکان مشخص می‌شود، نتایج فقط به‌سمت نتایج اطراف متمایل می‌شوند و به مکان‌های داخل منطقه محدود نمی‌شوند. وقتی می‌خواهید بااستفاده از رشته‌ای دلخواه مکان‌ها را جستجو کنید و در مواردی که نمی‌خواهید نتایج جستجو را به مکان خاصی محدود کنید، از textSearch استفاده کنید. از شیء PlaceSearchPagination می‌توان برای واکشی صفحه‌های اضافی نتایج استفاده کرد (اگر این آخرین صفحه نتایج باشد یا فقط یک صفحه نتایج وجود داشته باشد، مقدار آن تهی است).

میانای PlaceDetailsRequest

میانا google.maps.places.PlaceDetailsRequest

پرسمان جزئیات مکان برای ارسال به PlacesService.
placeId
نوع:  string
«شناسه مکان» مربوط به «مکانی» که جزئیات آن درخواست شده است.
fields optional
نوع:  Array<string> optional
فیلدهایی که باید در پاسخ جزئیات گنجانده شود، که برای آن صورت‌حساب صادر خواهد شد. اگر هیچ فیلدی مشخص نشده باشد یا ['ALL'] ارسال شده باشد، همه فیلدهای دردسترس برگردانده می‌شوند و هزینه آن‌ها محاسبه می‌شود (این کار برای استقرار تولید توصیه نمی‌شود). برای مشاهده فهرست فیلدها، PlaceResult را ببینید. فیلدهای تودرتو را می‌توان با مسیرهای نقطه‌ای (مثلاً "geometry.location") مشخص کرد.
language optional
نوع:  string optional
شناسه زبان برای زبانی که جزئیات باید به آن برگردانده شود. فهرست زبان‌های پشتیبانی‌شده را ببینید.
region optional
نوع:  string optional
کد منطقه کاربر. این امر می‌تواند بر عکس‌هایی که ممکن است برگردانده شوند و احتمالاً موارد دیگر تأثیر بگذارد. کد منطقه مقدار دو نویسه‌ای ccTLD («دامنه سطح بالا») را می‌پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با چند استثنای قابل‌توجه. برای مثال، دامنه سطح بالای کد کشوری پادشاهی متحد «uk» (.co.uk) است، درحالی‌که کد ISO 3166-1 آن «gb» است (که ازنظر فنی برای نهاد «پادشاهی متحد بریتانیای کبیر و ایرلند شمالی» است).
sessionToken optional
نوع:  AutocompleteSessionToken optional
مرجع منحصربه‌فردی که برای دسته‌بندی درخواست جزئیات با جلسه تکمیل خودکار استفاده می‌شود.

میانای FindPlaceFromPhoneNumberRequest

میانا google.maps.places.FindPlaceFromPhoneNumberRequest

درخواست جستجوی نوشتاری «یافتن مکان» برای ارسال به PlacesService.findPlaceFromPhoneNumber.
fields
نوع:  Array<string>
فیلدهایی که باید در پاسخ گنجانده شوند، که برای آن‌ها صورت‌حساب صادر خواهد شد. اگر ['ALL'] وارد شود، همه فیلدهای دردسترس برگردانده می‌شوند و صورت‌حساب برای آن‌ها صادر می‌شود (این کار برای استقرار تولید توصیه نمی‌شود). برای مشاهده فهرست فیلدها، PlaceResult را ببینید. فیلدهای تودرتو را می‌توان با مسیرهای نقطه‌ای (مثلاً "geometry.location") مشخص کرد.
phoneNumber
نوع:  string
شماره تلفن مکان موردنظر برای جستجو. قالب باید E.164 باشد.
language optional
نوع:  string optional
شناسه زبان برای زبانی که نام‌ها و نشانی‌ها باید به آن زبان برگردانده شوند (درصورت امکان). فهرست زبان‌های پشتیبانی‌شده را ببینید.
locationBias optional
نوع:  LocationBias optional
سوگیری مورداستفاده هنگام جستجوی «مکان». نتیجه به LocationBias ارائه‌شده متمایل خواهد بود، اما به آن محدود نخواهد شد.

میانای FindPlaceFromQueryRequest

میانا google.maps.places.FindPlaceFromQueryRequest

درخواست جستجوی نوشتاری «یافتن مکان» برای ارسال به PlacesService.findPlaceFromQuery.
fields
نوع:  Array<string>
فیلدهایی که باید در پاسخ گنجانده شوند، که برای آن‌ها صورت‌حساب صادر خواهد شد. اگر ['ALL'] وارد شود، همه فیلدهای دردسترس برگردانده می‌شوند و صورت‌حساب برای آن‌ها صادر می‌شود (این کار برای استقرار تولید توصیه نمی‌شود). برای مشاهده فهرست فیلدها، PlaceResult را ببینید. فیلدهای تودرتو را می‌توان با مسیرهای نقطه‌ای (مثلاً "geometry.location") مشخص کرد.
query
نوع:  string
پُرسمان درخواست. برای مثال، نام یا نشانی مکان.
language optional
نوع:  string optional
شناسه زبان برای زبانی که نام‌ها و نشانی‌ها باید به آن زبان برگردانده شوند (درصورت امکان). فهرست زبان‌های پشتیبانی‌شده را ببینید.
locationBias optional
نوع:  LocationBias optional
سوگیری مورداستفاده هنگام جستجوی «مکان». نتیجه به LocationBias ارائه‌شده متمایل خواهد بود، اما به آن محدود نخواهد شد.

میانای PlaceSearchRequest

میانا google.maps.places.PlaceSearchRequest

پرسمان جستجوی «مکان» برای ارسال به PlacesService.
bounds optional
محدوده‌ای که «مکان‌ها» در آن جستجو می‌شود. اگر bounds تنظیم شده باشد، location و radius نادیده گرفته خواهند شد.
keyword optional
نوع:  string optional
عبارتی که باید با همه فیلدهای دردسترس مطابقت داشته باشد، ازجمله نام، نوع، و نشانی، و همچنین مرورهای مشتری و دیگر محتواهای شخص ثالث.
language optional
نوع:  string optional
شناسه زبان برای زبانی که نام‌ها و نشانی‌ها باید به آن زبان برگردانده شوند (درصورت امکان). فهرست زبان‌های پشتیبانی‌شده را ببینید.
location optional
نوع:  LatLng|LatLngLiteral optional
مکان اطراف که می‌خواهید «مکان‌ها» را در آن جستجو کنید.
maxPriceLevel optional
نوع:  number optional
نتایج را فقط به مکان‌هایی با سطح قیمت مشخص‌شده یا پایین‌تر محدود می‌کند. مقادیر معتبر در محدوده ۰ (مقرون‌به‌صرفه‌ترین) تا ۴ (گران‌ترین) است. درصورت مشخص شدن، باید بیشتر از یا مساوی با minPrice باشد.
minPriceLevel optional
نوع:  number optional
نتایج را فقط به مکان‌هایی با سطح قیمت مشخص‌شده یا بالاتر محدود می‌کند. مقادیر معتبر در محدوده ۰ (مقرون‌به‌صرفه‌ترین) تا ۴ (گران‌ترین) است. درصورت مشخص شدن، باید کمتر یا مساوی با maxPrice باشد.
name optional
نوع:  string optional
معادل keyword. مقادیر این فیلد با مقادیر فیلد keyword ترکیب می‌شود و به‌عنوان بخشی از همان رشته جستجو ارسال می‌شود.
openNow optional
نوع:  boolean optional
نتایج را فقط به مکان‌هایی محدود می‌کند که درحال‌حاضر باز هستند.
radius optional
نوع:  number optional
فاصله از مکان داده‌شده که در آن «مکان‌ها» جستجو می‌شود، به متر. حداکثر مقدار مجاز ۵۰٬۰۰۰ است.
rankBy optional
نوع:  RankBy optional
پیش‌فرض: RankBy.PROMINENCE
روش رتبه‌بندی را برای استفاده هنگام برگرداندن نتایج تعیین می‌کند. توجه داشته باشید که وقتی rankBy روی DISTANCE تنظیم شده است، باید location را مشخص کنید اما نمی‌توانید radius یا bounds را مشخص کنید.
type optional
نوع:  string optional
مکان‌های نوع ارائه‌شده را جستجو می‌کند. نوع به زبان محلی مکان هدف درخواست ترجمه می‌شود و به‌عنوان رشته پُرسمان استفاده می‌شود. اگر پُرسمان هم ارائه شود، به رشته نوع بومی‌سازی‌شده الحاق می‌شود. نتایج از نوع متفاوت از پاسخ حذف می‌شوند. از این فیلد برای انجام جستجوهای دسته‌ای مستقل از زبان و منطقه استفاده کنید. انواع معتبر در اینجا ارائه شده است.

میانای TextSearchRequest

میانا google.maps.places.TextSearchRequest

درخواست جستجوی نوشتار برای ارسال به PlacesService.
bounds optional
مرزهایی که برای سوگیری نتایج هنگام جستجوی «مکان‌ها» استفاده می‌شود (اختیاری). اگر bounds تنظیم شده باشد، location و radius نادیده گرفته خواهند شد. نتایج به موارد داخل این مرزها محدود نخواهد شد؛ اما نتایج داخل آن رتبه بالاتری خواهند داشت.
language optional
نوع:  string optional
شناسه زبان برای زبانی که نام‌ها و نشانی‌ها باید به آن زبان برگردانده شوند (درصورت امکان). فهرست زبان‌های پشتیبانی‌شده را ببینید.
location optional
نوع:  LatLng|LatLngLiteral optional
مرکز منطقه‌ای که برای سوگیری نتایج هنگام جستجوی «مکان‌ها» استفاده می‌شود.
query optional
نوع:  string optional
عبارت پُرسمان درخواست. برای مثال، نام یک مکان («برج ایفل»)، یک دسته و سپس نام یک مکان («پیتزا در نیویورک»)، یا نام یک مکان و سپس یک ابهام‌زدای مکان («استارباکس در سیدنی»).
radius optional
نوع:  number optional
شعاع منطقه‌ای که برای سوگیری نتایج هنگام جستجوی «مکان‌ها» استفاده می‌شود، به متر.
region optional
نوع:  string optional
کد منطقه‌ای که نتایج به آن سوگیری داشته باشد. کد منطقه مقدار دو نویسه‌ای ccTLD («دامنه سطح بالا») را می‌پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با چند استثنای قابل‌توجه. برای مثال، دامنه سطح بالای کد کشوری پادشاهی متحد «uk» (.co.uk) است، درحالی‌که کد ISO 3166-1 آن «gb» است (که ازنظر فنی برای نهاد «پادشاهی متحد بریتانیای کبیر و ایرلند شمالی» است).
type optional
نوع:  string optional
مکان‌های نوع ارائه‌شده را جستجو می‌کند. نوع به زبان محلی مکان هدف درخواست ترجمه می‌شود و به‌عنوان رشته پُرسمان استفاده می‌شود. اگر پُرسمان هم ارائه شود، به رشته نوع بومی‌سازی‌شده الحاق می‌شود. نتایج از نوع متفاوت از پاسخ حذف می‌شوند. از این فیلد برای انجام جستجوهای دسته‌ای مستقل از زبان و منطقه استفاده کنید. انواع معتبر در اینجا ارائه شده است.

ثابت‌های RankBy

google.maps.places.RankBy یادآور همیشگی

گزینه‌های رتبه‌بندی برای PlaceSearchRequest.

با تماس با const {RankBy} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
DISTANCE نتایج مکان را براساس فاصله از مکان رتبه‌بندی می‌کند.
PROMINENCE نتایج مکان را براساس برجستگی آن‌ها رتبه‌بندی می‌کند.

LocationBias typedef

google.maps.places.LocationBias typedef

LocationBias نشان‌دهنده مرز نرم یا راهنمایی برای استفاده هنگام جستجوی «مکان‌ها» است. نتایج ممکن است از خارج از منطقه مشخص‌شده باشد. برای استفاده از نشانی IP کاربر فعلی به‌عنوان سوگیری، می‌توان رشته "IP_BIAS" را مشخص کرد. توجه: اگر از Circle استفاده می‌کنید، مرکز و شعاع باید تعریف شود.

LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

LocationRestriction نشان‌دهنده مرز دقیقی است که باید هنگام جستجوی «مکان‌ها» استفاده شود.

LatLngBounds|LatLngBoundsLiteral

ثابت‌های PlacesServiceStatus

google.maps.places.PlacesServiceStatus یادآور همیشگی

وضعیت برگردانده‌شده توسط PlacesService پس‌از تکمیل جستجوهای آن. این‌ها را براساس مقدار یا بااستفاده از نام ثابت مشخص کنید. برای مثال، 'OK' یا google.maps.places.PlacesServiceStatus.OK.

با تماس با const {PlacesServiceStatus} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
INVALID_REQUEST این درخواست نامعتبر بود.
NOT_FOUND مکان ارجاع‌داده‌شده پیدا نشد.
OK پاسخ حاوی نتیجه معتبری است.
OVER_QUERY_LIMIT برنامه از سهمیه درخواست خود فراتر رفته است.
REQUEST_DENIED برنامه اجازه ندارد از PlacesService استفاده کند.
UNKNOWN_ERROR درخواست PlacesService به‌دلیل خطای سرور پردازش نشد. اگر دوباره امتحان کنید، ممکن است درخواست موفقیت‌آمیز باشد.
ZERO_RESULTS هیچ نتیجه‌ای برای این درخواست پیدا نشد.

میانای PlaceSearchPagination

میانا google.maps.places.PlaceSearchPagination

شیئی که برای واکشی صفحه‌های اضافی نتایج «مکان‌ها» استفاده می‌شود.
hasNextPage
نوع:  boolean
نشان می‌دهد که آیا نتایج بیشتری دردسترس است یا نه. true وقتی صفحه نتایج دیگری وجود دارد.
nextPage
nextPage()
پارامترها:  هیچ
مقدار برگشتی:  void
صفحه بعدی نتایج را واکشی می‌کند. از همان تابع بازخوانی استفاده می‌کند که برای اولین درخواست جستجو ارائه شده بود.

میانای PlaceResult

میانا google.maps.places.PlaceResult

اطلاعات مربوط به «مکان» را تعریف می‌کند.
address_components optional
نوع:  Array<GeocoderAddressComponent> optional
مجموعه مؤلفه‌های نشانی برای مکان این «مکان». فقط با PlacesService.getDetails دردسترس است.
adr_address optional
نوع:  string optional
نمایش نشانی «مکان» در ریزقالب adr. فقط با PlacesService.getDetails دردسترس است.
aspects optional
نوع:  Array<PlaceAspectRating> optional
جنبه‌های رده‌بندی‌شده این «مکان»، براساس مرورهای کاربران Google و Zagat. رتبه‌بندی‌ها در مقیاس ۰ تا ۳۰ است.
business_status optional
نوع:  BusinessStatus optional
پرچمی که وضعیت عملیاتی «مکان» را نشان می‌دهد، اگر کسب‌وکار باشد (نشان می‌دهد که آیا مکان فعال است یا به‌طور موقت یا دائم بسته است). اگر داده‌ای دردسترس نباشد، پرچم در پاسخ‌های جستجو یا جزئیات وجود ندارد.
formatted_address optional
نوع:  string optional
نشانی کامل مکان.
formatted_phone_number optional
نوع:  string optional
شماره تلفن مکان، قالب‌بندی‌شده طبق قرارداد منطقه‌ای شماره. فقط با PlacesService.getDetails دردسترس است.
geometry optional
نوع:  PlaceGeometry optional
اطلاعات مربوط به هندسه «مکان».
html_attributions optional
نوع:  Array<string> optional
نوشتار انتساب برای نمایش در این نتیجه «مکان». html_attributions دردسترس همیشه صرف‌نظر از اینکه چه fields درخواست شده است برگردانده می‌شود و باید نمایش داده شود.
icon optional
نوع:  string optional
نشانی وب منبع تصویری که می‌تواند برای نمایش دسته این «مکان» استفاده شود.
icon_background_color optional
نوع:  string optional
رنگ پس‌زمینه برای استفاده با نماد «مکان». PlaceResult.icon_mask_base_uri را نیز ببینید.
icon_mask_base_uri optional
نوع:  string optional
نشانی وب کوتاه شده به ماسک نماد. با افزودن پسوند فایل به انتها (یعنی .svg یا .png)، به انواع مختلف نماد دسترسی پیدا کنید.
international_phone_number optional
نوع:  string optional
شماره تلفن مکان در قالب بین‌المللی. قالب بین‌المللی شامل کد کشور است و پیشوند آن علامت به‌علاوه (+) است. فقط با PlacesService.getDetails دردسترس است.
name optional
نوع:  string optional
نام مکان. توجه: درمورد «مکان‌های» واردشده توسط کاربر، این نوشتار خام است، همان‌طور که کاربر تایپ کرده است. لطفاً هنگام استفاده از این داده‌ها احتیاط کنید، زیرا کاربران مخرب ممکن است سعی کنند از آن به‌عنوان بردار برای حملات تزریق کد استفاده کنند (به http://en.wikipedia.org/wiki/Code_injection مراجعه کنید).
opening_hours optional
نوع:  PlaceOpeningHours optional
تعیین می‌کند که «مکان» چه زمانی باز یا بسته می‌شود.
permanently_closed optional
نوع:  boolean optional
پرچمی که نشان می‌دهد مکان به‌طور دائم یا موقت بسته است. اگر مکان فعال باشد یا اگر داده‌ای دردسترس نباشد، پرچم در پاسخ وجود ندارد.
photos optional
نوع:  Array<PlacePhoto> optional
عکس‌های این مکان. این مجموعه حداکثر ده شیء PlacePhoto خواهد داشت.
place_id optional
نوع:  string optional
شناسه یکتای «مکان».
plus_code optional
نوع:  PlacePlusCode optional
«کدهای مکان باز» یا «کدهای پلاس» را برای «مکان» تعریف می‌کند.
price_level optional
نوع:  number optional
سطح قیمت «مکان»، در مقیاس ۰ تا ۴. سطوح قیمت به‌صورت زیر تفسیر می‌شوند:
  • 0: رایگان
  • 1: ارزان
  • ‫2: متوسط
  • ‫3: گران
  • ‫4: بسیار گران
rating optional
نوع:  number optional
رده‌بندی بین ۱٫۰ تا ۵٫۰ براساس مرورهای کاربران از این «مکان».
reviews optional
نوع:  Array<PlaceReview> optional
فهرستی از مرورهای این «مکان». فقط با PlacesService.getDetails دردسترس است.
types optional
نوع:  Array<string> optional
آرایه‌ای از نوع برای این «مکان» (برای مثال، ["political", "locality"] یا ["restaurant", "establishment"]).
url optional
نوع:  string optional
نشانی وب صفحه رسمی Google برای این مکان. این صفحه متعلق به Google است که حاوی بهترین اطلاعات موجود درباره «مکان» است. فقط با PlacesService.getDetails دردسترس است.
user_ratings_total optional
نوع:  number optional
تعداد رده‌بندی‌های کاربر که در PlaceResult.rating این مکان نقش داشته است.
utc_offset optional
نوع:  number optional
انحراف از UTC منطقه زمانی فعلی «مکان»، برحسب دقیقه. برای مثال، سیدنی استرالیا در ساعت تابستانی ۱۱ ساعت جلوتر از ساعت هماهنگ جهانی است، بنابراین utc_offset برابر با 660 خواهد بود. برای مناطق زمانی عقب‌تر از ساعت هماهنگ جهانی، اختلاف منفی است. برای مثال، utc_offset برای کیپ ورد -60 است. فقط با PlacesService.getDetails دردسترس است.
utc_offset_minutes optional
نوع:  number optional
انحراف از UTC منطقه زمانی فعلی «مکان»، برحسب دقیقه. برای مثال، سیدنی استرالیا در ساعت تابستانی ۱۱ ساعت جلوتر از ساعت هماهنگ جهانی است، بنابراین utc_offset_minutes برابر با 660 خواهد بود. برای مناطق زمانی عقب‌تر از ساعت هماهنگ جهانی، اختلاف منفی است. برای مثال، utc_offset_minutes برای کیپ ورد -60 است. فقط با PlacesService.getDetails دردسترس است.
vicinity optional
نوع:  string optional
نشانی ساده‌شده برای «مکان»، شامل نام خیابان، شماره خیابان، و محل، اما نه استان/ایالت، کد پستی، یا کشور. برای مثال، مقدار مجاورت دفتر Google در سیدنی استرالیا "48 Pirrama Road, Pyrmont" است. فقط با PlacesService.getDetails دردسترس است.
website optional
نوع:  string optional
وب‌سایت معتبر برای این «مکان»، مثل صفحه اصلی کسب‌وکار. فقط با PlacesService.getDetails دردسترس است.

میانای PlaceAspectRating

میانا google.maps.places.PlaceAspectRating

اطلاعاتی را درباره جنبه‌ای از مکان که کاربران مرور کرده‌اند تعریف می‌کند.
rating
نوع:  number
رده‌بندی این جنبه. برای مرورهای جداگانه، این مقدار عدد صحیحی بین ۰ تا ۳ است. برای رده‌بندی‌های تجمیع‌شده یک مکان، این عدد صحیحی بین ۰ تا ۳۰ است.
type
نوع:  string
نوع جنبه. برای مثال، "food"، "decor"، "service"، یا "overall".

ثابت‌های BusinessStatus

google.maps.places.BusinessStatus یادآور همیشگی

وضعیت فعالیت «مکان»، اگر کسب‌وکار باشد، در PlaceResult برگردانده می‌شود (نشان می‌دهد که مکان فعال است یا موقتاً یا برای همیشه بسته است). این موارد را براساس مقدار یا نام ثابت مشخص کنید (مثال: 'OPERATIONAL' یا google.maps.places.BusinessStatus.OPERATIONAL).

با تماس با const {BusinessStatus} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
CLOSED_PERMANENTLY کسب‌وکار برای همیشه بسته شده است.
CLOSED_TEMPORARILY کسب‌وکار موقتاً بسته است.
OPERATIONAL کسب‌وکار به‌طور عادی فعالیت می‌کند.

میانای PlaceGeometry

میانا google.maps.places.PlaceGeometry

اطلاعات مربوط به هندسه «مکان» را تعریف می‌کند.
location optional
نوع:  LatLng optional
موقعیت «مکان».
viewport optional
نوع:  LatLngBounds optional
ناحیه نمایش ترجیحی هنگام نمایش این «مکان» روی نقشه. اگر نمای ترجیحی «مکان» مشخص نباشد، این ویژگی null خواهد بود. فقط با PlacesService.getDetails دردسترس است.

میانای PlaceOpeningHours

میانا google.maps.places.PlaceOpeningHours

اطلاعات مربوط به ساعات کاری «مکان» را تعریف می‌کند.
open_now optional
نوع:  boolean optional
آیا «مکان» درحال‌حاضر باز است یا نه.
periods optional
نوع:  Array<PlaceOpeningHoursPeriod> optional
دوره‌های باز بودن برای هر روز هفته، از یکشنبه، به‌ترتیب زمانی. روزهایی که «مکان» باز نیست لحاظ نمی‌شود. فقط با PlacesService.getDetails دردسترس است.
weekday_text optional
نوع:  Array<string> optional
آرایه‌ای از هفت رشته که نشان‌دهنده ساعت کاری قالب‌بندی‌شده برای هر روز هفته است. «سرویس مکان‌ها» ساعت کاری را به‌طور مناسب برای زبان فعلی قالب‌بندی و بومی‌سازی می‌کند. ترتیب عناصر در این آرایه به زبان بستگی دارد. در برخی زبان‌ها هفته از دوشنبه شروع می‌شود، درحالی‌که در برخی دیگر از یکشنبه شروع می‌شود. فقط با PlacesService.getDetails دردسترس است. سایر تماس‌ها ممکن است آرایه خالی برگردانند.
isOpen
isOpen([date])
پارامترها: 
  • ‫date:  Date optional
مقدار برگشتی:  boolean|undefined
بررسی کنید که آیا مکان اکنون باز است (وقتی تاریخی ارسال نشده است) یا در تاریخ ارائه‌شده باز است. اگر این مکان PlaceResult.utc_offset_minutes یا PlaceOpeningHours.periods نداشته باشد، undefined برگردانده می‌شود (PlaceOpeningHours.periods فقط ازطریق PlacesService.getDetails دردسترس است). این روش ساعات کاری استثنایی، مثل ساعات کاری تعطیلات، را درنظر نمی‌گیرد.

میانای PlaceOpeningHoursPeriod

میانا google.maps.places.PlaceOpeningHoursPeriod

اطلاعات ساختاریافته درباره ساعات کاری «مکان» را تعریف می‌کند. توجه: اگر «مکان» همیشه باز باشد، بخش close در پاسخ وجود نخواهد داشت. کارخواهان می‌توانند مطمئن باشند که همیشه باز بودن به‌صورت دوره open نشان داده می‌شود که حاوی day با مقدار 0 و time با مقدار "0000" است و close ندارد.
open
ساعت باز شدن «مکان».
close optional
نوع:  PlaceOpeningHoursTime optional
ساعت بسته شدن «مکان».

میانای PlaceOpeningHoursTime

میانا google.maps.places.PlaceOpeningHoursTime

تعیین می‌کند که «مکان» چه زمانی باز یا بسته می‌شود.
day
نوع:  number
روزهای هفته، به‌صورت عددی در محدوده [0، 6]، که از یکشنبه شروع می‌شود. برای مثال، 2 یعنی سه‌شنبه.
hours
نوع:  number
ساعت PlaceOpeningHoursTime.time به‌صورت عدد، در محدوده [0، 23]. این مقدار در منطقه زمانی «مکان» گزارش خواهد شد.
minutes
نوع:  number
دقیقه PlaceOpeningHoursTime.time به‌صورت عدد، در محدوده [0، 59]. این مقدار در منطقه زمانی «مکان» گزارش خواهد شد.
time
نوع:  string
زمان روز در قالب ۲۴ ساعته «hhmm». مقادیر در محدوده ["0000"، "2359"] هستند. زمان در منطقه زمانی «مکان» گزارش خواهد شد.
nextDate optional
نوع:  number optional
مُهر زمان (به‌صورت میلی‌ثانیه از مبدأ تاریخ، مناسب برای استفاده با new Date()) که نشان‌دهنده وقوع بعدی این PlaceOpeningHoursTime است. این مقدار از PlaceOpeningHoursTime.day هفته، PlaceOpeningHoursTime.time، و PlaceResult.utc_offset_minutes محاسبه می‌شود. اگر PlaceResult.utc_offset_minutes‏ undefined باشد، nextDate‏ undefined خواهد بود.

میانای PlacePlusCode

میانا google.maps.places.PlacePlusCode

«کدهای مکان باز» یا «کدهای پلاس» را برای «مکان» تعریف می‌کند. در جاهایی که نشانی خیابان وجود ندارد (جایی که ساختمان‌ها شماره ندارند یا خیابان‌ها نام ندارند)، می‌توان از Plus Code به‌عنوان جایگزین نشانی خیابان استفاده کرد.
global_code
نوع:  string
plus code با مساحت ۱/۸۰۰۰ درجه در ۱/۸۰۰۰ درجه. به‌عنوان مثال، "8FVC9G8F+5W".
compound_code optional
نوع:  string optional
plus code با مساحت ۱/۸۰۰۰ درجه در ۱/۸۰۰۰ درجه که چهار نویسه اول (پیش‌شماره) حذف شده و با شرح محل جایگزین شده است. به‌عنوان مثال، "9G8F+5W Zurich, Switzerland". اگر هیچ محل مناسبی برای کوتاه کردن کد پیدا نشود، این فیلد حذف می‌شود.

میانای PlacePhoto

میانا google.maps.places.PlacePhoto

نشان‌دهنده عنصر عکس «مکان» است.
height
نوع:  number
ارتفاع عکس به پیکسل.
html_attributions
نوع:  Array<string>
نوشتار انتساب برای نمایش در این عکس.
width
نوع:  number
عرض عکس به پیکسل.
getUrl
getUrl([opts])
پارامترها: 
مقدار برگشتی:  string
نشانی وب تصویر مربوط به گزینه‌های مشخص‌شده را برمی‌گرداند.

PhotoOptions میانجی

میانا google.maps.places.PhotoOptions

گزینه‌های درخواست عکس را تعریف می‌کند.
maxHeight optional
نوع:  number optional
حداکثر ارتفاع تصویر برگردانده‌شده به پیکسل.
maxWidth optional
نوع:  number optional
حداکثر عرض تصویر برگردانده‌شده به پیکسل.

میانای PlaceReview

میانا google.maps.places.PlaceReview

نشان‌دهنده یک مرور از مکان است.
author_name
نوع:  string
نام مرورکننده.
language
نوع:  string
کد زبان IETF که نشان‌دهنده زبانی است که این مرور به آن نوشته شده است. توجه داشته باشید که این کد فقط شامل برچسب زبان اصلی است و هیچ برچسب ثانویه‌ای که نشان‌دهنده کشور یا منطقه باشد ندارد. برای مثال، همه مرورهای انگلیسی به‌جای «en-AU» یا «en-UK» با برچسب 'en' نشان‌گذاری می‌شوند.
profile_photo_url
نوع:  string
نشانی وب تصویر نمایه مرورکننده.
relative_time_description
نوع:  string
رشته‌ای از زمان اخیر قالب‌بندی‌شده که زمان مرور را نسبت به زمان فعلی در قالبی مناسب برای زبان و کشور بیان می‌کند. برای مثال "a month ago".
text
نوع:  string
نوشتار مرور.
time
نوع:  number
مُهر زمان برای مرور، برحسب ثانیه از تاریخ بیان می‌شود.
aspects optional
نوع:  Array<PlaceAspectRating> optional
جنبه‌هایی که در این مرور رده‌بندی شده است. رده‌بندی‌ها در مقیاس ۰ تا ۳.
author_url optional
نوع:  string optional
نشانی وب نمایه مرورکننده. وقتی نمایه مرورگر دردسترس نباشد، این undefined خواهد بود.
rating optional
نوع:  number optional
رده‌بندی این مرور، عددی بین ۱٫۰ و ۵٫۰ (شامل این دو عدد).