اعلامیه: سبک نقشه پایه جدید به زودی به پلتفرم نقشه های گوگل می آید. این به‌روزرسانی برای استایل نقشه شامل یک پالت رنگی پیش‌فرض جدید، پین‌های مدرن شده و بهبودهایی در تجربه‌ها و قابلیت استفاده از نقشه است. همه سبک‌های نقشه به‌طور خودکار در مارس 2025 به‌روزرسانی می‌شوند. برای اطلاعات بیشتر در مورد در دسترس بودن و نحوه انتخاب زودتر، به سبک نقشه جدید برای پلتفرم Google Maps مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Places Service

کلاس PlacesService

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

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

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

سازنده
`PlacesService`	`PlacesService(attrContainer)` پارامترها: `attrContainer` : `HTMLDivElement \| Map` یک نمونه جدید از `PlacesService` ایجاد می کند که اسناد را در ظرف مشخص شده ارائه می کند.

روش ها
`findPlaceFromPhoneNumber`	`findPlaceFromPhoneNumber(request, callback)` پارامترها: `request` : `FindPlaceFromPhoneNumberRequest` `callback` : `function( Array < PlaceResult > optional , PlacesServiceStatus ): void` ارزش بازگشتی: ندارد لیستی از مکان ها را بر اساس شماره تلفن بازیابی می کند. در بیشتر موارد باید فقط یک مورد در لیست نتایج وجود داشته باشد، اما اگر درخواست مبهم باشد ممکن است بیش از یک نتیجه برگردانده شود. `PlaceResult` های ارسال شده به callback زیر مجموعه های یک `PlaceResult` کامل هستند. برنامه شما می تواند با تماس با `PlacesService.getDetails` و ارسال `PlaceResult.place_id` برای مکان مورد نظر، `PlaceResult` دقیق تری برای هر مکان دریافت کند.
`findPlaceFromQuery`	`findPlaceFromQuery(request, callback)` پارامترها: `request` : `FindPlaceFromQueryRequest` `callback` : `function( Array < PlaceResult > optional , PlacesServiceStatus ): void` ارزش بازگشتی: ندارد فهرستی از مکان ها را بر اساس یک رشته پرس و جو بازیابی می کند. در بیشتر موارد باید فقط یک مورد در لیست نتایج وجود داشته باشد، اما اگر درخواست مبهم باشد ممکن است بیش از یک نتیجه برگردانده شود. `PlaceResult` های ارسال شده به callback زیر مجموعه های یک `PlaceResult` کامل هستند. برنامه شما می تواند با تماس با `PlacesService.getDetails` و ارسال `PlaceResult.place_id` برای مکان مورد نظر، `PlaceResult` دقیق تری برای هر مکان دریافت کند.
`getDetails`	`getDetails(request, callback)` پارامترها: `request` : `PlaceDetailsRequest` `callback` : `function( PlaceResult optional , PlacesServiceStatus ): void` ارزش بازگشتی: ندارد جزئیات مربوط به مکان شناسایی شده توسط `placeId` داده شده را بازیابی می کند.
`nearbySearch`	`nearbySearch(request, callback)` پارامترها: `request` : `PlaceSearchRequest` `callback` : `function( Array < PlaceResult > optional , PlacesServiceStatus , PlaceSearchPagination optional ): void` ارزش بازگشتی: ندارد فهرستی از مکان های نزدیک به یک مکان خاص را بر اساس کلمه کلیدی یا نوع بازیابی می کند. مکان باید همیشه مشخص شود، یا با عبور از `LatLngBounds` ، یا پارامترهای `location` و `radius` . `PlaceResult` های ارسال شده به callback زیرمجموعه های `PlaceResult` کامل هستند. برنامه شما می‌تواند با ارسال یک درخواست Place Details با ارسال `PlaceResult.place_id` برای مکان مورد نظر، `PlaceResult` دقیق‌تری برای هر مکان دریافت کند. شی `PlaceSearchPagination` می تواند برای واکشی صفحات اضافی از نتایج استفاده شود (اگر این آخرین صفحه نتایج باشد یا اگر فقط یک صفحه از نتایج وجود داشته باشد، تهی است).
`textSearch`	`textSearch(request, callback)` پارامترها: `request` : `TextSearchRequest` `callback` : `function( Array < PlaceResult > optional , PlacesServiceStatus , PlaceSearchPagination optional ): void` ارزش بازگشتی: ندارد فهرستی از مکان‌ها را بر اساس یک رشته جستجو بازیابی می‌کند (به عنوان مثال، "پیتزا در نیویورک"، یا "فروشگاه‌های کفش در نزدیکی اتاوا"). پارامترهای مکان اختیاری هستند. هنگامی که مکان مشخص می شود، نتایج به جای محدود شدن به مکان های داخل منطقه، فقط نسبت به نتایج نزدیک تعصب دارند. هنگامی که می خواهید مکان ها را با استفاده از یک رشته دلخواه جستجو کنید و در مواردی که ممکن است نخواهید نتایج جستجو را به یک مکان خاص محدود کنید، از `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`	منسوخ شده: به جای آن `keyword` استفاده کنید. نوع: `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 مرکز و شعاع باید تعریف شود.

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()` پارامترها: ندارد مقدار برگشتی: `void` صفحه بعدی نتایج را واکشی می کند. از همان عملکرد برگشت به تماس استفاده می کند که برای اولین درخواست جستجو ارائه شده است.

رابط 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` از مه 2020 منسوخ شده است و در ماه مه 2021 خاموش خواهد شد. استفاده از `PlaceResult.business_status` به جای آن به عنوان `permanently_closed` بین بسته شدن موقت و دائم تمایز قائل نمی شود. نوع: `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` از نوامبر 2019 منسوخ شده است. به جای آن از `PlaceResult.utc_offset_minutes` استفاده کنید. https://goo.gle/js-open-now را ببینید نوع: `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` از نوامبر 2019 منسوخ شده است. به جای آن از روش `PlaceOpeningHours.isOpen` از یک نتیجه `PlacesService.getDetails` استفاده کنید. https://goo.gle/js-open-now را ببینید نوع: `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` در دسترس است). این روش ساعات استثنایی مانند ساعات تعطیلات را در نظر نمی گیرد.

روش ها

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`	نوع: `PlaceOpeningHoursTime` زمان افتتاحیه برای مکان.
`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"` . اگر مکان مناسبی برای کوتاه کردن کد پیدا نشود، این قسمت حذف می شود.

خواص

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

Places Service

کلاس PlacesService

سازنده

روش ها

رابط PlaceDetailsRequest

خواص

رابط FindPlaceFromPhoneNumberRequest

خواص

رابط FindPlaceFromQueryRequest

خواص

رابط PlaceSearchRequest

خواص

رابط TextSearchRequest

خواص

ثابت های RankBy

ثابت ها

LocationBias typedef

LocationRestriction typedef

ثابت های PlacesServiceStatus

ثابت ها

رابط PlaceSearchPagination

خواص

روش ها

رابط PlaceResult

خواص

رابط PlaceAspectRating

خواص

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

ثابت ها

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

خواص

رابط PlaceOpeningHours

خواص

روش ها

رابط PlaceOpeningHoursPeriod

خواص

رابط PlaceOpeningHoursTime

خواص

رابط PlacePlusCode

خواص

رابط PlacePhoto

خواص

روش ها

رابط PhotoOptions

خواص

رابط PlaceReview

خواص