Places Service

کلاس PlacesService

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

رابط PlaceDetailsRequest

google.maps.places . 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 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی").
sessionToken optional
نوع: AutocompleteSessionToken optional
مرجع منحصر به فرد مورد استفاده برای بسته بندی درخواست جزئیات با یک جلسه تکمیل خودکار.

رابط FindPlaceFromPhoneNumberRequest

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

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

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 .

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.

با فراخوانی 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 | LatLngBounds | LatLngBoundsLiteral | Circle | CircleLiteral |string

LocationRestriction typedef

google.maps.places . LocationRestriction typedef

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

LatLngBounds | LatLngBoundsLiteral

ثابت های PlacesServiceStatus

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

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

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

رابط PlaceResult

google.maps.places . 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. رتبه بندی در مقیاس 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

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

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 ).

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

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

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

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

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

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

رابط PlaceOpeningHours

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

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

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 اعتماد کنند.

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

رابط PlaceOpeningHoursTime

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

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

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

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

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

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

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

رابط PhotoOptions

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

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

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

رابط PlaceReview

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

کلاس PlacesService

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

رابط PlaceDetailsRequest

google.maps.places . 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 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی").
sessionToken optional
نوع: AutocompleteSessionToken optional
مرجع منحصر به فرد مورد استفاده برای بسته بندی درخواست جزئیات با یک جلسه تکمیل خودکار.

رابط FindPlaceFromPhoneNumberRequest

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

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

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

A text search request to be sent to the PlacesService .

bounds optional
نوع: LatLngBounds | LatLngBoundsLiteral optional
Bounds used to bias results when searching for Places (optional). Both location and radius will be ignored if bounds is set. Results will not be restricted to those inside these bounds; but, results inside it will rank higher.
language optional
نوع: string optional
A language identifier for the language in which names and addresses should be returned, when possible. See the list of supported languages .
location optional
نوع: LatLng | LatLngLiteral optional
The center of the area used to bias results when searching for Places.
query optional
نوع: string optional
The request's query term. For example, the name of a place ('Eiffel Tower'), a category followed by the name of a location ('pizza in New York'), or the name of a place followed by a location disambiguator ('Starbucks in Sydney').
radius optional
نوع: number optional
The radius of the area used to bias results when searching for Places, in meters.
region optional
نوع: string optional
A region code to bias results towards. The region code accepts a ccTLD ("top-level domain") two-character value. Most ccTLD codes are identical to ISO 3166-1 codes, with some notable exceptions. For example, the United Kingdom's ccTLD is "uk" ( .co.uk ) while its ISO 3166-1 code is "gb" (technically for the entity of "The United Kingdom of Great Britain and Northern Ireland").
type optional
نوع: string optional
Searches for places of the given type. The type is translated to the local language of the request's target location and used as a query string. If a query is also provided, it is concatenated to the localized type string. Results of a different type are dropped from the response. Use this field to perform language and region independent categorical searches. Valid types are given here .

RankBy constants

google.maps.places . RankBy constants

Ranking options for a PlaceSearchRequest.

Access by calling const {RankBy} = await google.maps.importLibrary("places") . کتابخانه ها را در Maps JavaScript API ببینید.

DISTANCE Ranks place results by distance from the location.
PROMINENCE Ranks place results by their prominence.

LocationBias typedef

google.maps.places . LocationBias typedef

A LocationBias represents a soft boundary or hint to use when searching for Places. Results may come from outside the specified area. To use the current user's IP address as a bias, the string "IP_BIAS" can be specified. Note: if using a Circle the center and radius must be defined.

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

LocationRestriction typedef

google.maps.places . LocationRestriction typedef

A LocationRestriction represents a strict boundary to use when searching for Places.

LatLngBounds | LatLngBoundsLiteral

PlacesServiceStatus constants

google.maps.places . PlacesServiceStatus constants

The status returned by the PlacesService on the completion of its searches. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. For example, 'OK' or google.maps.places.PlacesServiceStatus.OK .

Access by calling const {PlacesServiceStatus} = await google.maps.importLibrary("places") . کتابخانه ها را در Maps JavaScript API ببینید.

INVALID_REQUEST This request was invalid.
NOT_FOUND The place referenced was not found.
OK The response contains a valid result.
OVER_QUERY_LIMIT The application has gone over its request quota.
REQUEST_DENIED The application is not allowed to use the PlacesService .
UNKNOWN_ERROR The PlacesService request could not be processed due to a server error. The request may succeed if you try again.
ZERO_RESULTS No result was found for this request.

PlaceSearchPagination interface

google.maps.places . PlaceSearchPagination interface

An object used to fetch additional pages of Places results.

hasNextPage
Type: boolean
Indicates if further results are available. true when there is an additional results page.
nextPage
nextPage()
پارامترها: ندارد
ارزش بازگشتی: ندارد
Fetches the next page of results. Uses the same callback function that was provided to the first search request.

PlaceResult interface

google.maps.places . PlaceResult interface

Defines information about a Place.

address_components optional
Type: Array < GeocoderAddressComponent > optional
The collection of address components for this Place's location. Only available with PlacesService.getDetails .
adr_address optional
نوع: string optional
The representation of the Place's address in the adr microformat . Only available with PlacesService.getDetails .
aspects optional
Type: Array < PlaceAspectRating > optional
The rated aspects of this Place, based on Google and Zagat user reviews. The ratings are on a scale of 0 to 30.
business_status optional
Type: BusinessStatus optional
A flag indicating the operational status of the Place, if it is a business (indicates whether the place is operational, or closed either temporarily or permanently). If no data is available, the flag is not present in search or details responses.
formatted_address optional
نوع: string optional
The Place's full address.
formatted_phone_number optional
نوع: string optional
The Place's phone number, formatted according to the number's regional convention . Only available with PlacesService.getDetails .
geometry optional
Type: PlaceGeometry optional
The Place's geometry-related information.
html_attributions optional
Type: Array <string> optional
Attribution text to be displayed for this Place result. Available html_attributions are always returned regardless of what fields have been requested, and must be displayed.
icon optional
نوع: string optional
URL to an image resource that can be used to represent this Place's category.
icon_background_color optional
نوع: string optional
Background color for use with a Place's icon. See also PlaceResult.icon_mask_base_uri .
icon_mask_base_uri optional
نوع: string optional
A truncated URL to an icon mask. Access different icon types by appending a file extension to the end (ie .svg or .png ).
international_phone_number optional
نوع: string optional
The Place's phone number in international format. International format includes the country code, and is prefixed with the plus (+) sign. Only available with PlacesService.getDetails .
name optional
نوع: string optional
The Place's name. Note: In the case of user entered Places, this is the raw text, as typed by the user. Please exercise caution when using this data, as malicious users may try to use it as a vector for code injection attacks (See http://en.wikipedia.org/wiki/Code_injection ).
opening_hours optional
Type: PlaceOpeningHours optional
Defines when the Place opens or closes.
permanently_closed optional permanently_closed optional
نوع: boolean optional
A flag indicating whether the Place is closed, either permanently or temporarily. If the place is operational, or if no data is available, the flag is absent from the response.
photos optional
Type: Array < PlacePhoto > optional
Photos of this Place. The collection will contain up to ten PlacePhoto objects.
place_id optional
نوع: string optional
A unique identifier for the Place.
plus_code optional
Type: PlacePlusCode optional
Defines Open Location Codes or " plus codes " for the Place.
price_level optional
نوع: number optional
The price level of the Place, on a scale of 0 to 4. Price levels are interpreted as follows:
  • 0 : Free
  • 1 : Inexpensive
  • 2 : Moderate
  • 3 : Expensive
  • 4 : Very Expensive
rating optional
نوع: number optional
A rating, between 1.0 to 5.0, based on user reviews of this Place.
reviews optional
Type: Array < PlaceReview > optional
A list of reviews of this Place. Only available with PlacesService.getDetails .
types optional
Type: Array <string> optional
An array of types for this Place (for example, ["political", "locality"] or ["restaurant", "establishment"] ).
url optional
نوع: string optional
URL of the official Google page for this place. This is the Google-owned page that contains the best available information about the Place. Only available with PlacesService.getDetails .
user_ratings_total optional
نوع: number optional
The number of user ratings which contributed to this Place's PlaceResult.rating .
utc_offset optional utc_offset optional
نوع: number optional
The offset from UTC of the Place's current timezone, in minutes. For example, Sydney, Australia in daylight savings is 11 hours ahead of UTC, so the utc_offset will be 660 . For timezones behind UTC, the offset is negative. For example, the utc_offset is -60 for Cape Verde. Only available with PlacesService.getDetails .
utc_offset_minutes optional
نوع: number optional
The offset from UTC of the Place's current timezone, in minutes. For example, Sydney, Australia in daylight savings is 11 hours ahead of UTC, so the utc_offset_minutes will be 660 . For timezones behind UTC, the offset is negative. For example, the utc_offset_minutes is -60 for Cape Verde. Only available with PlacesService.getDetails .
vicinity optional
نوع: string optional
The simplified address for the Place, including the street name, street number, and locality, but not the province/state, postal code, or country. For example, Google's Sydney, Australia office has a vicinity value of "48 Pirrama Road, Pyrmont" . Only available with PlacesService.getDetails .
website optional
نوع: string optional
The authoritative website for this Place, such as a business' homepage. Only available with PlacesService.getDetails .

PlaceAspectRating interface

google.maps.places . PlaceAspectRating interface

Defines information about an aspect of the place that users have reviewed.

rating
Type: number
The rating of this aspect. For individual reviews this is an integer from 0 to 3. For aggregated ratings of a place this is an integer from 0 to 30.
type
نوع: string
The aspect type. For example, "food" , "decor" , "service" , or "overall" .

BusinessStatus constants

google.maps.places . BusinessStatus constants

The operational status of the Place, if it is a business, returned in a PlaceResult (indicates whether the place is operational, or closed either temporarily or permanently). Specify these by value, or the constant's name (example: 'OPERATIONAL' or google.maps.places.BusinessStatus.OPERATIONAL ).

Access by calling const {BusinessStatus} = await google.maps.importLibrary("places") . کتابخانه ها را در Maps JavaScript API ببینید.

CLOSED_PERMANENTLY The business is closed permanently.
CLOSED_TEMPORARILY The business is closed temporarily.
OPERATIONAL The business is operating normally.

PlaceGeometry interface

google.maps.places . PlaceGeometry interface

Defines information about the geometry of a Place.

location optional
نوع: LatLng optional
The Place's position.
viewport optional
Type: LatLngBounds optional
The preferred viewport when displaying this Place on a map. This property will be null if the preferred viewport for the Place is not known. Only available with PlacesService.getDetails .

PlaceOpeningHours interface

google.maps.places . PlaceOpeningHours interface

Defines information about the opening hours of a Place.

open_now optional open_now optional
نوع: boolean optional
Whether the Place is open at the current time.
periods optional
Type: Array < PlaceOpeningHoursPeriod > optional
Opening periods covering for each day of the week, starting from Sunday, in chronological order. Days in which the Place is not open are not included. Only available with PlacesService.getDetails .
weekday_text optional
Type: Array <string> optional
An array of seven strings representing the formatted opening hours for each day of the week. The Places Service will format and localize the opening hours appropriately for the current language. The ordering of the elements in this array depends on the language. Some languages start the week on Monday while others start on Sunday. Only available with PlacesService.getDetails . Other calls may return an empty array.
isOpen
isOpen([date])
مولفه های:
  • date : Date optional
Return Value: boolean|undefined
Check whether the place is open now (when no date is passed), or at the given date. If this place does not have PlaceResult.utc_offset_minutes or PlaceOpeningHours.periods then undefined is returned ( PlaceOpeningHours.periods is only available via PlacesService.getDetails ). This method does not take exceptional hours, such as holiday hours, into consideration.

PlaceOpeningHoursPeriod interface

google.maps.places . PlaceOpeningHoursPeriod interface

Defines structured information about the opening hours of a Place. Note: If a Place is always open , the close section will be missing from the response. Clients can rely on always-open being represented as an open period containing day with value 0 and time with value "0000" , and no close .

open
The opening time for the Place.
close optional
Type: PlaceOpeningHoursTime optional
The closing time for the Place.

PlaceOpeningHoursTime interface

google.maps.places . PlaceOpeningHoursTime interface

Defines when a Place opens or closes.

day
Type: number
The days of the week, as a number in the range [ 0 , 6 ], starting on Sunday. For example, 2 means Tuesday.
hours
Type: number
The hours of the PlaceOpeningHoursTime.time as a number, in the range [ 0 , 23 ]. This will be reported in the Place's time zone.
minutes
Type: number
The minutes of the PlaceOpeningHoursTime.time as a number, in the range [ 0 , 59 ]. This will be reported in the Place's time zone.
time
نوع: string
The time of day in 24-hour "hhmm" format. Values are in the range [ "0000" , "2359" ]. The time will be reported in the Place's time zone.
nextDate optional
نوع: number optional
The timestamp (as milliseconds since the epoch, suitable for use with new Date() ) representing the next occurrence of this PlaceOpeningHoursTime. It is calculated from the PlaceOpeningHoursTime.day of week, the PlaceOpeningHoursTime.time , and the PlaceResult.utc_offset_minutes . If the PlaceResult.utc_offset_minutes is undefined , then nextDate will be undefined .

PlacePlusCode interface

google.maps.places . PlacePlusCode interface

Defines Open Location Codes or " plus codes " for a Place. Plus codes can be used as a replacement for street addresses in places where they do not exist (where buildings are not numbered or streets are not named).

global_code
نوع: string
A plus code with a 1/8000th of a degree by 1/8000th of a degree area. For example, "8FVC9G8F+5W" .
compound_code optional
نوع: string optional
A plus code with a 1/8000th of a degree by 1/8000th of a degree area where the first four characters (the area code) are dropped and replaced with a locality description. For example, "9G8F+5W Zurich, Switzerland" . If no suitable locality that can be found to shorten the code then this field is omitted.

PlacePhoto interface

google.maps.places . PlacePhoto interface

Represents a photo element of a Place.

height
Type: number
The height of the photo in pixels.
html_attributions
Type: Array <string>
Attribution text to be displayed for this photo.
width
Type: number
The width of the photo in pixels.
getUrl
getUrl([opts])
مولفه های:
Return Value: string
Returns the image URL corresponding to the specified options.

PhotoOptions interface

google.maps.places . PhotoOptions interface

Defines photo-requesting options.

maxHeight optional
نوع: number optional
The maximum height in pixels of the returned image.
maxWidth optional
نوع: number optional
The maximum width in pixels of the returned image.

PlaceReview interface

google.maps.places . PlaceReview interface

Represents a single review of a place.

author_name
نوع: string
The name of the reviewer.
language
نوع: string
An IETF language code indicating the language in which this review is written. Note that this code includes only the main language tag without any secondary tag indicating country or region. For example, all the English reviews are tagged as 'en' rather than 'en-AU' or 'en-UK'.
profile_photo_url
نوع: string
A URL to the reviwer's profile image.
relative_time_description
نوع: string
A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country. For example "a month ago" .
text
نوع: string
The text of a review.
time
Type: number
Timestamp for the review, expressed in seconds since epoch.
aspects optional aspects optional
Type: Array < PlaceAspectRating > optional
The aspects rated by the review. The ratings on a scale of 0 to 3.
author_url optional
نوع: string optional
A URL to the reviewer's profile. This will be undefined when the reviewer's profile is unavailable.
rating optional
نوع: number optional
The rating of this review, a number between 1.0 and 5.0 (inclusive).