Places Service

با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

کلاس PlacesService

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

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در 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 کامل هستند. برنامه شما می‌تواند با ارسال یک درخواست Place Details با ارسال PlaceResult.place_id برای مکان مورد نظر، PlaceResult دقیق‌تری برای هر مکان دریافت کند. شی PlaceSearchPagination می تواند برای واکشی صفحات اضافی از نتایج استفاده شود (اگر این آخرین صفحه نتایج باشد یا اگر فقط یک صفحه از نتایج وجود داشته باشد، تهی است).
textSearch
textSearch(request, callback)
مولفه های:
ارزش بازگشتی: ندارد
فهرستی از مکان‌ها را بر اساس یک رشته جستجو بازیابی می‌کند (به عنوان مثال، "پیتزا در نیویورک"، یا "فروشگاه‌های کفش در نزدیکی اتاوا"). پارامترهای مکان اختیاری هستند. هنگامی که مکان مشخص می شود، نتایج به جای محدود شدن به مکان های داخل منطقه، فقط نسبت به نتایج نزدیک تعصب دارند. هنگامی که می خواهید مکان ها را با استفاده از یک رشته دلخواه جستجو کنید و در مواردی که ممکن است نخواهید نتایج جستجو را به یک مکان خاص محدود کنید، از textSearch استفاده کنید. شی PlaceSearchPagination می تواند برای واکشی صفحات اضافی از نتایج استفاده شود (اگر این آخرین صفحه نتایج باشد یا اگر فقط یک صفحه از نتایج وجود داشته باشد، تهی است).

رابط PlaceDetailsRequest

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

درخواست جزئیات مکان برای ارسال به PlacesService .

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

رابط FindPlaceFromPhoneNumberRequest

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

مکان یافتن از درخواست جستجوی متنی برای ارسال به PlacesService.findPlaceFromPhoneNumber .

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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 رابط google.maps.places . FindPlaceFromQueryRequest

مکان یافتن از درخواست جستجوی متن برای ارسال به PlacesService.findPlaceFromQuery .

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

رابط PlaceSearchRequest

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

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

رابط TextSearchRequest

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

یک درخواست جستجوی متنی برای ارسال به PlacesService .

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

bounds optional
نوع: LatLngBounds | LatLngBoundsLiteral 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 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی").
type optional
نوع: string optional
مکان هایی از نوع داده شده را جستجو می کند. نوع به زبان محلی محل مورد نظر درخواست ترجمه شده و به عنوان رشته پرس و جو استفاده می شود. اگر یک پرس و جو نیز ارائه شود، به رشته نوع محلی سازی شده الحاق می شود. نتایج یک نوع متفاوت از پاسخ حذف می شوند. از این فیلد برای انجام جستجوهای مقوله ای مستقل از زبان و منطقه استفاده کنید. انواع معتبر در اینجا آورده شده است.

ثابت های RankBy

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

گزینه های رتبه بندی برای درخواست PlaceSearch.

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

DISTANCE نتایج مکان را بر اساس فاصله از مکان رتبه بندی می کند.
PROMINENCE رتبه ها نتایج را بر اساس برجستگی خود قرار می دهند.

LocationBias typedef

google.maps.places . LocationBias typedef

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

LocationRestriction typedef

google.maps.places . LocationRestriction typedef

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

LatLngBounds | LatLngBoundsLiteral

ثابت های PlacesServiceStatus

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

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

INVALID_REQUEST این درخواست نامعتبر بود.
NOT_FOUND مکان مورد اشاره یافت نشد.
OK پاسخ حاوی یک نتیجه معتبر است.
OVER_QUERY_LIMIT برنامه از سهمیه درخواست خود عبور کرده است.
REQUEST_DENIED برنامه مجاز به استفاده از PlacesService نیست.
UNKNOWN_ERROR درخواست PlacesService به دلیل خطای سرور قابل پردازش نیست. اگر دوباره تلاش کنید ممکن است درخواست با موفقیت انجام شود.
ZERO_RESULTS هیچ نتیجه ای برای این درخواست یافت نشد.

رابط PlaceSearchPagination

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

شیء مورد استفاده برای واکشی صفحات اضافی از نتایج Places.

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

رابط PlaceResult

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

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

address_components optional
نوع: Array < GeocoderAddressComponent > optional
مجموعه اجزای آدرس برای مکان این مکان. فقط با PlacesService.getDetails موجود است.
adr_address optional
نوع: string optional
نمایش آدرس مکان در میکروفرمت adr . فقط با PlacesService.getDetails موجود است.
aspects optional
نوع: Array < PlaceAspectRating > optional
جنبه‌های رتبه‌بندی شده این مکان، بر اساس نظرات کاربران Google و Zagat. رتبه بندی در مقیاس 0 تا 30 است.
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
یک URL کوتاه شده به یک ماسک نماد. با افزودن پسوند فایل به انتها (به عنوان مثال .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 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 تا 4. سطوح قیمت به صورت زیر تفسیر می شود:
  • 0 : رایگان
  • 1 : ارزان
  • 2 : متوسط
  • 3 : گران است
  • 4 : بسیار گران است
rating optional
نوع: number optional
امتیازی بین 1.0 تا 5.0 بر اساس نظرات کاربران از این مکان.
reviews optional
نوع: Array < PlaceReview > optional
فهرستی از نظرات درباره این مکان. فقط با PlacesService.getDetails موجود است.
types optional
نوع: Array <string> optional
آرایه‌ای از انواع برای این مکان (برای مثال، ["political", "locality"] یا ["restaurant", "establishment"] ).
url optional
نوع: string optional
URL صفحه رسمی گوگل برای این مکان. این صفحه متعلق به Google است که حاوی بهترین اطلاعات موجود در مورد مکان است. فقط با PlacesService.getDetails موجود است.
user_ratings_total optional
نوع: number optional
تعداد رتبه‌بندی‌های کاربرانی که در رتبه‌بندی PlaceResult.rating این مکان مشارکت داشته‌اند.
utc_offset optional utc_offset optional
نوع: number optional
انحراف از UTC منطقه زمانی فعلی Place، در دقیقه. به عنوان مثال، سیدنی، استرالیا در صرفه جویی در روز 11 ساعت جلوتر از UTC است، بنابراین utc_offset 660 خواهد بود. برای مناطق زمانی پشت UTC، افست منفی است. به عنوان مثال، utc_offset برای کیپ ورد -60 است. فقط با PlacesService.getDetails موجود است.
utc_offset_minutes optional
نوع: number optional
انحراف از UTC منطقه زمانی فعلی Place، در دقیقه. به عنوان مثال، سیدنی، استرالیا در صرفه جویی در روز 11 ساعت جلوتر از UTC است، بنابراین utc_offset_minutes 660 خواهد بود. برای مناطق زمانی پشت UTC، افست منفی است. به عنوان مثال، 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 رابط google.maps.places . PlaceAspectRating

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

rating
نوع: number
رتبه بندی این جنبه. برای نظرات فردی، این یک عدد صحیح از 0 تا 3 است. برای رتبه‌بندی‌های انبوه یک مکان، این یک عدد صحیح از 0 تا 30 است.
type
نوع: string
نوع جنبه برای مثال، "food" ، "decor" ، "service" یا "overall" .

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

google.maps.places . BusinessStatus ثابت های وضعیت google.maps.places . BusinessStatus

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

رابط مکان هندسه

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

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

رابط PlaceOpeningHours

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

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

open_now optional 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 رابط google.maps.places . PlaceOpeningHoursPeriod

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

رابط PlaceOpeningHoursTime

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

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

day
نوع: number
روزهای هفته، به عنوان یک عدد در محدوده [ 0 ، 6 ]، از یکشنبه شروع می شود. مثلا 2 یعنی سه شنبه.
hours
نوع: number
ساعات PlaceOpeningHoursTime.time به عنوان یک عدد، در محدوده [ 0 ، 23 ]. این در منطقه زمانی Place گزارش خواهد شد.
minutes
نوع: number
دقیقه PlaceOpeningHoursTime.time به عنوان یک عدد، در محدوده [ 0 ، 59 ]. این در منطقه زمانی Place گزارش خواهد شد.
time
نوع: string
ساعت شبانه روز با فرمت 24 ساعته "هوم". مقادیر در محدوده [ "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 رابط google.maps.places . PlacePlusCode

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

رابط PlacePhoto

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

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

رابط PhotoOptions

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

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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

رابط PlaceReview

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

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

به پارامتر &libraries=places URL نیاز دارد. کتابخانه ها را در Maps JavaScript API ببینید.

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 aspects optional
نوع: Array < PlaceAspectRating > optional
جنبه های رتبه بندی شده توسط بررسی. رتبه بندی در مقیاس 0 تا 3.
author_url optional
نوع: string optional
URL به نمایه بازبین. وقتی نمایه بازبین در دسترس نباشد، این مورد undefined است.
rating optional
نوع: number optional
امتیاز این بررسی، عددی بین 1.0 تا 5.0 (شامل).