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

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

Place

محل کلاس

google.maps.places . Place کلاس

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

سازنده
`Place`	`Place(options)` مولفه های: `options` : `PlaceOptions`

روش های استاتیک
`searchByText`	`searchByText(request)` مولفه های: `request` : `SearchByTextRequest` مقدار بازگشتی: `Promise <{places: Array < Place >}>` جستجوی مکان مبتنی بر پرس و جو متنی.
`searchNearby`	`searchNearby(request)` مولفه های: `request` : `SearchNearbyRequest` مقدار بازگشتی: `Promise <{places: Array < Place >}>` مکان های نزدیک را جستجو کنید.

خواص
`accessibilityOptions`	نوع: `AccessibilityOptions optional` گزینه‌های دسترس‌پذیری این مکان. اگر داده های گزینه های دسترسی از سرور فراخوانی نشده باشد، `undefined` .
`addressComponents`	نوع: `Array < AddressComponent > optional` مجموعه اجزای آدرس برای مکان این مکان. اگر داده آدرس مشخصی وجود ندارد، شی را خالی کنید. اگر داده های آدرس از سرور فراخوانی نشده باشد، `undefined` .
`adrFormatAddress`	نوع: `string optional` نمایش آدرس مکان در میکروفرمت adr .
`allowsDogs`	نوع: `boolean optional`
`attributions`	نوع: `Array < Attribution > optional` متن انتساب برای این نتیجه مکان نمایش داده شود.
`businessStatus`	نوع: `BusinessStatus optional` وضعیت عملیاتی مکان اگر وضعیت شناخته شده ای وجود نداشته باشد، `null` . اگر داده های وضعیت از سرور بارگیری نشده باشد، `undefined` .
`displayName`	نوع: `string optional` نام نمایشی مکان اگر نامی وجود نداشته باشد، `null` . اگر داده های نام از سرور بارگیری نشده باشد، `undefined` .
`displayNameLanguageCode`	نوع: `string optional` زبان نام نمایشی مکان. اگر نامی وجود نداشته باشد، `null` . اگر داده های نام از سرور بارگیری نشده باشد، `undefined` .
`editorialSummary`	نوع: `string optional` خلاصه سرمقاله برای این مکان. اگر خلاصه ویرایشی وجود نداشته باشد، `null` . اگر این فیلد هنوز درخواست نشده باشد، `undefined` .
`editorialSummaryLanguageCode`	نوع: `string optional` زبان خلاصه سرمقاله برای این مکان. اگر خلاصه ویرایشی وجود نداشته باشد، `null` . اگر این فیلد هنوز درخواست نشده باشد، `undefined` .
`evChargeOptions`	نوع: `EVChargeOptions optional` گزینه های شارژ EV ارائه شده توسط مکان. اگر گزینه های شارژ EV از سرور فراخوانی نشده باشد، `undefined` .
`formattedAddress`	نوع: `string optional` آدرس کامل مکان ها
`fuelOptions`	نوع: `FuelOptions optional` گزینه های سوخت ارائه شده توسط مکان. اگر گزینه های سوخت از سرور فراخوانی نشده باشد، `undefined` .
`googleMapsURI`	نوع: `string optional` URL صفحه رسمی گوگل برای این مکان. این صفحه متعلق به Google است که حاوی بهترین اطلاعات موجود در مورد مکان است.
`hasCurbsidePickup`	نوع: `boolean optional` اینکه آیا مکانی دارای وانت کنار خیابان است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`hasDelivery`	نوع: `boolean optional` اینکه آیا مکانی تحویل دارد یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`hasDineIn`	نوع: `boolean optional` اینکه آیا مکانی غذاخوری دارد یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`hasLiveMusic`	نوع: `boolean optional`
`hasMenuForChildren`	نوع: `boolean optional`
`hasOutdoorSeating`	نوع: `boolean optional`
`hasRestroom`	نوع: `boolean optional`
`hasTakeout`	نوع: `boolean optional` اینکه آیا مکانی دارای بیرون‌بر است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`hasWiFi`	نوع: `boolean optional`
`iconBackgroundColor`	نوع: `string optional` کد رنگ HEX پیش‌فرض برای دسته مکان.
`id`	نوع: `string` شناسه مکان منحصر به فرد
`internationalPhoneNumber`	نوع: `string optional` شماره تلفن مکان در قالب بین المللی. قالب بین المللی شامل کد کشور است و با علامت مثبت (+) پیشوند است.
`isGoodForChildren`	نوع: `boolean optional`
`isGoodForGroups`	نوع: `boolean optional`
`isGoodForWatchingSports`	نوع: `boolean optional`
`isReservable`	نوع: `boolean optional` اینکه آیا یک مکان قابل رزرو است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`location`	نوع: `LatLng optional` موقعیت مکان
`nationalPhoneNumber`	نوع: `string optional` شماره تلفن مکان، که بر اساس کنوانسیون منطقه‌ای شماره قالب‌بندی شده است.
`parkingOptions`	نوع: `ParkingOptions optional` گزینه های پارکینگ ارائه شده توسط مکان. اگر اطلاعات گزینه های پارکینگ از سرور فراخوانی نشده باشد، `undefined` .
`paymentOptions`	نوع: `PaymentOptions optional` گزینه های پرداخت ارائه شده توسط مکان. اگر داده های گزینه های پرداخت از سرور فراخوانی نشده باشد، `undefined` .
`photos`	نوع: `Array < Photo > optional` عکس های این مکان این مجموعه شامل حداکثر ده شیء `Photo` است.
`plusCode`	نوع: `PlusCode optional`
`priceLevel`	نوع: `PriceLevel optional` سطح قیمت مکان. این ویژگی می تواند هر یک از مقادیر زیر را برگرداند `Free` `Inexpensive` `Moderate` `Expensive` `Very Expensive`
`primaryType`	نوع: `string optional` نوع اصلی مکان در صورتی که هیچ نوع وجود نداشته باشد `null` . اگر نوع داده از سرور بارگیری نشده باشد، `undefined` .
`primaryTypeDisplayName`	نوع: `string optional` نام نمایشی نوع اصلی مکان. در صورتی که هیچ نوع وجود نداشته باشد `null` . اگر نوع داده از سرور بارگیری نشده باشد، `undefined` .
`primaryTypeDisplayNameLanguageCode`	نوع: `string optional` زبان نام نمایشی نوع اصلی مکان. در صورتی که هیچ نوع وجود نداشته باشد `null` . اگر نوع داده از سرور بارگیری نشده باشد، `undefined` .
`rating`	نوع: `number optional` امتیازی بین 1.0 تا 5.0 بر اساس نظرات کاربران از این مکان.
`regularOpeningHours`	نوع: `OpeningHours optional`
`requestedLanguage`	نوع: `string optional` زبان درخواستی برای این مکان.
`requestedRegion`	نوع: `string optional` منطقه درخواستی برای این مکان.
`reviews`	نوع: `Array < Review > optional` فهرستی از نظرات برای این مکان.
`servesBeer`	نوع: `boolean optional` این که آیا در مکانی آبجو سرو می شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`servesBreakfast`	نوع: `boolean optional` این که آیا یک مکان صبحانه سرو می کند. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`servesBrunch`	نوع: `boolean optional` این که آیا در مکانی برانچ سرو می شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`servesCocktails`	نوع: `boolean optional`
`servesCoffee`	نوع: `boolean optional`
`servesDessert`	نوع: `boolean optional`
`servesDinner`	نوع: `boolean optional` اینکه آیا در مکانی شام سرو می شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`servesLunch`	نوع: `boolean optional` این که آیا یک مکان ناهار سرو می کند. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`servesVegetarianFood`	نوع: `boolean optional` اینکه آیا در مکانی غذای گیاهی سرو می شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`servesWine`	نوع: `boolean optional` این که آیا یک مکان شراب سرو می کند. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`svgIconMaskURI`	نوع: `string optional` URI به منبع ماسک تصویر svg که می تواند برای نشان دادن دسته یک مکان استفاده شود.
`types`	نوع: `Array <string> optional` آرایه‌ای از انواع برای این مکان (برای مثال، `["political", "locality"]` یا `["restaurant", "establishment"]` ).
`userRatingCount`	نوع: `number optional` تعداد رتبه‌بندی‌های کاربرانی که در `Place.rating` این مکان مشارکت داشته‌اند.
`utcOffsetMinutes`	نوع: `number optional` انحراف از UTC منطقه زمانی فعلی Place، در دقیقه. به عنوان مثال، ساعت استاندارد شرقی اتریش (GMT+10) در صرفه جویی در روز 11 ساعت جلوتر از UTC است، بنابراین `utc_offset_minutes` `660` خواهد بود. برای مناطق زمانی پشت UTC، افست منفی است. به عنوان مثال، `utc_offset_minutes` برای کیپ ورد `-60` است.
`viewport`	نوع: `LatLngBounds optional` نمای ترجیحی هنگام نمایش این مکان بر روی نقشه.
`websiteURI`	نوع: `string optional` وب سایت معتبر برای این مکان، مانند صفحه اصلی یک کسب و کار.
`openingHours`	منسوخ شده: به جای آن از `Place.regularOpeningHours` استفاده کنید. نوع: `OpeningHours optional`

مواد و روش ها
`fetchFields`	`fetchFields(options)` مولفه های: `options` : `FetchFieldsRequest` مقدار بازگشتی: `Promise <{place: Place }>`
`getNextOpeningTime`	توجه: فقط در کانال v=beta موجود است. `getNextOpeningTime([date])` مولفه های: `date` : `Date optional` مقدار بازگشتی: `Promise < Date optional >` تاریخ نشان دهنده OpeningHoursTime بعدی را محاسبه می کند. اگر داده ها برای محاسبه نتیجه کافی نباشد، یا این مکان عملیاتی نباشد، تعریف نشده برمی گردد.
`isOpen`	توجه: فقط در کانال v=beta موجود است. `isOpen([date])` مولفه های: `date` : `Date optional` پیش‌فرض تا کنون. مقدار بازگشتی: `Promise <boolean optional >` بررسی کنید که آیا مکان در تاریخ معین باز است یا خیر. اگر داده های شناخته شده برای مکان برای محاسبه آن کافی نباشد، به عنوان مثال اگر ساعات کاری ثبت نشده باشد، با `undefined` حل می شود.
`toJSON`	`toJSON()` پارامترها: ندارد Return Value: یک شی JSON با تمام خصوصیات Place درخواست شده `Object` .

رابط PlaceOptions

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

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

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

کلاس AccessibilityOptions

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

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

خواص
`hasWheelchairAccessibleEntrance`	نوع: `boolean optional` آیا مکانی دارای ورودی قابل دسترسی با صندلی چرخدار است یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`hasWheelchairAccessibleParking`	نوع: `boolean optional` اینکه آیا مکانی دارای پارکینگ قابل دسترسی برای ویلچر است یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`hasWheelchairAccessibleRestroom`	نوع: `boolean optional` آیا مکانی دارای سرویس بهداشتی قابل دسترسی برای ویلچر است یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`hasWheelchairAccessibleSeating`	نوع: `boolean optional` آیا مکانی برای صندلی چرخدار در دسترس است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.

AddressComponent کلاس

google.maps.places . AddressComponent کلاس

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

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

کلاس اسناد

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

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

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

کلاس AuthorAttribution

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

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

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

کلاس ConnectorAggregation

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

اطلاعات شارژ EV، جمع آوری شده برای کانکتورهایی از همان نوع و نرخ شارژ یکسان.

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

خواص
`availabilityLastUpdateTime`	نوع: `Date optional` زمانی که آخرین بار اطلاعات در دسترس بودن رابط در این مجموعه به‌روزرسانی شد.
`availableCount`	نوع: `number optional` تعداد رابط‌های موجود در این مجموعه که در حال حاضر در دسترس هستند.
`count`	نوع: `number` تعداد کانکتورها در این تجمع.
`maxChargeRateKw`	نوع: `number` حداکثر نرخ شارژ استاتیک به کیلووات هر کانکتور تجمع.
`outOfServiceCount`	نوع: `number optional` تعداد رابط‌های موجود در این مجموعه که در حال حاضر از سرویس خارج هستند.
`type`	نوع: `EVConnectorType optional` نوع رابط این تجمع.

کلاس EVChargeOptions

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

اطلاعاتی در مورد ایستگاه شارژ EV میزبانی شده در محل.

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

خواص
`connectorAggregations`	نوع: `Array < ConnectorAggregation >` فهرستی از کانکتورهای شارژ EV که حاوی کانکتورهایی با همان نوع و نرخ شارژ یکسان هستند.
`connectorCount`	نوع: `number` تعداد کانکتورها در این ایستگاه از آنجایی که برخی از پورت ها می توانند چندین کانکتور داشته باشند اما فقط می توانند یک خودرو را در یک زمان شارژ کنند، تعداد کانکتورها ممکن است بیشتر از تعداد کل خودروهایی باشد که می توانند به طور همزمان شارژ شوند.

خواص

connectorAggregations

نوع: Array < ConnectorAggregation >

فهرستی از کانکتورهای شارژ EV که حاوی کانکتورهایی با همان نوع و نرخ شارژ یکسان هستند.

connectorCount

نوع: number

تعداد کانکتورها در این ایستگاه از آنجایی که برخی از پورت ها می توانند چندین کانکتور داشته باشند اما فقط می توانند یک خودرو را در یک زمان شارژ کنند، تعداد کانکتورها ممکن است بیشتر از تعداد کل خودروهایی باشد که می توانند به طور همزمان شارژ شوند.

ثابت های EVConnectorType

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

انواع کانکتور شارژ EV

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

ثابت ها
`CCS_COMBO_1`	سیستم شارژ ترکیبی (AC و DC). بر اساس کانکتور SAE Type-1 J-1772.
`CCS_COMBO_2`	سیستم شارژ ترکیبی (AC و DC). بر اساس کانکتور Type-2 Mennekes.
`CHADEMO`	کانکتور نوع CHAdeMO.
`J1772`	کانکتور J1772 نوع 1.
`OTHER`	سایر انواع کانکتور
`TESLA`	کانکتور عمومی TESLA. این NACS در آمریکای شمالی است اما می‌تواند در سایر نقاط جهان غیرNACS باشد (مانند CCS Combo 2 (CCS2) یا GB/T). این مقدار کمتر معرف یک نوع اتصال دهنده واقعی است و بیشتر نشان دهنده توانایی شارژ خودروی برند تسلا در ایستگاه شارژ متعلق به تسلا است.
`TYPE_2`	کانکتور IEC 62196 نوع 2. اغلب به عنوان MENNEKES شناخته می شود.
`UNSPECIFIED_GB_T`	نوع GB/T مطابق با استاندارد GB/T در چین است. این نوع همه انواع GB_T را پوشش می دهد.
`UNSPECIFIED_WALL_OUTLET`	پریز دیواری نامشخص

رابط EVSearchOptions

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

گزینه های مربوط به EV که می توانند برای درخواست جستجوی مکان مشخص شوند.

خواص
`connectorTypes optional`	نوع: `Array < EVConnectorType > optional` فهرست انواع کانکتورهای EV ترجیحی. مکانی که از هیچ یک از انواع اتصال دهنده های ذکر شده پشتیبانی نمی کند، فیلتر می شود.
`minimumChargingRateKw optional`	نوع: `number optional` حداقل نرخ شارژ مورد نیاز بر حسب کیلووات. مکانی با نرخ شارژ کمتر از نرخ مشخص شده فیلتر می شود.

رابط FetchFieldsRequest

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

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

خواص
`fields`	نوع: `Array <string>` لیست فیلدهایی که باید واکشی شوند.

کلاس FuelOptions

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

جدیدترین اطلاعات در مورد گزینه های سوخت در پمپ بنزین. این اطلاعات به طور مرتب به روز می شود.

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

خواص
`fuelPrices`	نوع: `Array < FuelPrice >` لیست قیمت سوخت برای هر نوع سوخت این جایگاه، یک ورودی به ازای هر نوع سوخت.

کلاس FuelPrice

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

اطلاعات قیمت سوخت برای یک نوع سوخت مشخص.

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

خواص
`price`	نوع: `Money optional` قیمت سوخت.
`type`	نوع: `FuelType optional` نوع سوخت.
`updateTime`	نوع: `Date optional` زمان آخرین به روز رسانی قیمت سوخت

ثابت های نوع سوخت

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

انواع سوخت.

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

ثابت ها
`BIO_DIESEL`	بیو دیزل.
`DIESEL`	سوخت دیزلی.
`E80`	E 80.
`E85`	E 85.
`LPG`	LPG.
`METHANE`	متان
`MIDGRADE`	متوسطه.
`PREMIUM`	حق بیمه.
`REGULAR_UNLEADED`	بدون سرب معمولی
`SP100`	SP 100.
`SP91`	SP 91.
`SP91_E10`	SP 91 E10.
`SP92`	SP 92.
`SP95`	SP 95.
`SP95_E10`	SP95 E10.
`SP98`	SP 98.
`SP99`	SP 99.
`TRUCK_DIESEL`	دیزل کامیون.

کلاس پول

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

نمایش مقداری پول با نوع ارز آن.

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

خواص
`currencyCode`	نوع: `string` کد ارز سه حرفی که در ISO 4217 تعریف شده است.
`nanos`	نوع: `number` تعداد نانو (10^-9) واحد مقدار.
`units`	نوع: `number` کل واحدهای مقدار. برای مثال، اگر `Money.currencyCode` "USD" باشد، 1 واحد برابر با 1 دلار آمریکا است.

مواد و روش ها
`toString`	`toString()` پارامترها: ندارد مقدار بازگشتی: `string` یک نمایش قابل خواندن برای انسان از مقدار پول با نماد ارز آن را برمی گرداند.

کلاس OpeningHours

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

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

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

خواص

periods

نوع: Array < OpeningHoursPeriod >

دوره های افتتاحیه که هر روز هفته را پوشش می دهد، از یکشنبه، به ترتیب زمانی شروع می شود. شامل روزهایی نمی شود که مکان باز نیست.

weekdayDescriptions

نوع: Array <string>

آرایه‌ای از هفت رشته که ساعات کار قالب‌بندی شده را برای هر روز هفته نشان می‌دهد. سرویس مکان‌ها ساعت‌های کاری را به‌طور مناسب برای زبان فعلی قالب‌بندی و بومی‌سازی می‌کند. ترتیب عناصر در این آرایه به زبان بستگی دارد. برخی از زبان ها هفته را از دوشنبه شروع می کنند، در حالی که برخی دیگر از یکشنبه شروع می شوند.

کلاس OpeningHoursPeriod

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

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

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

کلاس OpeningHoursPoint

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

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

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

کلاس پارکینگ آپشن

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

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

خواص
`hasFreeGarageParking`	نوع: `boolean optional` اینکه آیا مکانی پارکینگ گاراژ رایگان ارائه می‌دهد. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`hasFreeParkingLot`	نوع: `boolean optional` اینکه آیا مکانی پارکینگ رایگان ارائه می دهد. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`hasFreeStreetParking`	نوع: `boolean optional` اینکه آیا مکانی پارکینگ خیابانی رایگان ارائه می‌دهد. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`hasPaidGarageParking`	نوع: `boolean optional` اینکه آیا مکانی پارکینگ گاراژ پولی ارائه می‌دهد. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`hasPaidParkingLot`	نوع: `boolean optional` آیا مکانی پارکینگ‌های پولی ارائه می‌دهد. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`hasPaidStreetParking`	نوع: `boolean optional` اینکه آیا مکانی پارکینگ خیابانی پولی ارائه می‌دهد. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`hasValetParking`	نوع: `boolean optional` اینکه آیا مکانی پارکینگ خدماتی ارائه می‌دهد. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.

کلاس PaymentOptions

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

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

خواص
`acceptsCashOnly`	نوع: `boolean optional` اینکه آیا مکانی فقط پرداخت از طریق نقدی را می پذیرد. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`acceptsCreditCards`	نوع: `boolean optional` آیا مکانی پرداخت از طریق کارت اعتباری را می پذیرد یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`acceptsDebitCards`	نوع: `boolean optional` آیا مکانی پرداخت از طریق کارت نقدی را می پذیرد یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.
`acceptsNFC`	نوع: `boolean optional` آیا مکانی پرداخت از طریق NFC را می پذیرد یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند.

کلاس عکس

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

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

خواص
`authorAttributions`	نوع: `Array < AuthorAttribution >` متن ذکر منبع برای این عکس نمایش داده شود.
`heightPx`	نوع: `number` ارتفاع عکس بر حسب پیکسل
`widthPx`	نوع: `number` عرض عکس بر حسب پیکسل

مواد و روش ها
`getURI`	`getURI([options])` مولفه های: `options` : `PhotoOptions optional` مقدار بازگشتی: `string` URL تصویر مربوط به گزینه های مشخص شده را برمی گرداند.

کلاس پلاس کد

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

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

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

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

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

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

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

ثابت ها
`EXPENSIVE`
`FREE`
`INEXPENSIVE`
`MODERATE`
`VERY_EXPENSIVE`

مرور کلاس

google.maps.places . Review کلاس

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

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

رابط SearchByTextRequest

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

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

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

ثابت های SearchByTextRankPreference

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

Enum RankPreference برای SearchByTextRequest.

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

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

رابط SearchNearbyRequest

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

درخواست رابط برای Place.searchNearby . برای اطلاعات بیشتر در مورد درخواست، مرجع Places API را ببینید.

خواص
`fields`	نوع: `Array <string>` فیلدهایی که باید در پاسخ گنجانده شوند، که برای آن صورت‌حساب دریافت می‌شود . اگر `['*']` وارد شود، همه فیلدهای موجود برگردانده می‌شوند و برای آنها صورت‌حساب دریافت می‌شود (این برای استقرار تولید توصیه نمی‌شود). می توانید هر خاصیت را در کلاس `Place` به عنوان فیلد درخواست کنید.
`locationRestriction`	نوع: `Circle \| CircleLiteral` منطقه مورد جستجو، به عنوان یک دایره با مرکز و شعاع مشخص شده است. نتایج خارج از مکان مشخص شده برگردانده نمی شوند.
`excludedPrimaryTypes optional`	نوع: `Array <string> optional` نوع مکان اصلی حذف شده است. لیست کامل انواع پشتیبانی شده را ببینید. یک مکان فقط می تواند یک نوع اولیه داشته باشد. حداکثر 50 نوع ممکن است مشخص شود. اگر یک نوع را در لیست های `included` و `excluded` مشخص کنید، یک خطای INVALID_ARGUMENT برگردانده می شود.
`excludedTypes optional`	نوع: `Array <string> optional` نوع مکان حذف شده لیست کامل انواع پشتیبانی شده را ببینید. یک مکان می تواند انواع مختلفی از مکان داشته باشد. حداکثر 50 نوع ممکن است مشخص شود. اگر یک نوع را در لیست های `included` و `excluded` مشخص کنید، یک خطای INVALID_ARGUMENT برگردانده می شود.
`includedPrimaryTypes optional`	نوع: `Array <string> optional` شامل نوع مکان اصلی لیست کامل انواع پشتیبانی شده را ببینید. یک مکان فقط می تواند یک نوع اولیه داشته باشد. حداکثر 50 نوع ممکن است مشخص شود. اگر یک نوع را در لیست های `included` و `excluded` مشخص کنید، یک خطای INVALID_ARGUMENT برگردانده می شود.
`includedTypes optional`	نوع: `Array <string> optional` شامل نوع مکان لیست کامل انواع پشتیبانی شده را ببینید. یک مکان می تواند انواع مختلفی از مکان داشته باشد. حداکثر 50 نوع ممکن است مشخص شود. اگر یک نوع را در لیست های `included` و `excluded` مشخص کنید، یک خطای INVALID_ARGUMENT برگردانده می شود.
`language optional`	نوع: `string optional` جزئیات مکان در صورت وجود با زبان ترجیحی نمایش داده می شود. به‌طور پیش‌فرض به اولویت زبان مرورگر خواهد بود. لیست فعلی زبان های پشتیبانی شده: https://developers.google.com/maps/faq#languagesupport .
`maxResultCount optional`	نوع: `number optional` حداکثر تعداد نتایج برای بازگشت. باید بین 1 تا 20 باشد.
`rankPreference optional`	نوع: `SearchNearbyRankPreference optional` پیش‌فرض: `SearchNearbyRankPreference.DISTANCE` نتایج چگونه در پاسخ رتبه بندی خواهند شد.
`region optional`	نوع: `string optional` کد کشور/منطقه یونیکد (CLDR) مکانی که درخواست از آنجا می آید. این پارامتر برای نمایش جزئیات مکان، مانند نام مکان خاص منطقه، در صورت وجود استفاده می شود. این پارامتر می تواند بر نتایج بر اساس قانون قابل اجرا تأثیر بگذارد. برای اطلاعات بیشتر، به https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html مراجعه کنید. توجه داشته باشید که کدهای منطقه 3 رقمی در حال حاضر پشتیبانی نمی شوند.

SearchNearbyRankPreference ثابت

google.maps.places . SearchNearbyRankPreference ثابت

فهرست رتبه‌بندی برای SearchNearbyRequest.

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

ثابت ها
`DISTANCE`	نتایج را بر اساس مسافت رتبه بندی می کند.
`POPULARITY`	نتایج را بر اساس محبوبیت رتبه بندی می کند.

Place

محل کلاس

سازنده

روش های استاتیک

خواص

مواد و روش ها

رابط PlaceOptions

خواص

کلاس AccessibilityOptions

خواص

AddressComponent کلاس

خواص

کلاس اسناد

خواص

کلاس AuthorAttribution

خواص

کلاس ConnectorAggregation

خواص

کلاس EVChargeOptions

خواص

ثابت های EVConnectorType

ثابت ها

رابط EVSearchOptions

خواص

رابط FetchFieldsRequest

خواص

کلاس FuelOptions

خواص

کلاس FuelPrice

خواص

ثابت های نوع سوخت

ثابت ها

کلاس پول

خواص

مواد و روش ها

کلاس OpeningHours

خواص

کلاس OpeningHoursPeriod

خواص

کلاس OpeningHoursPoint

خواص

کلاس پارکینگ آپشن

خواص

کلاس PaymentOptions

خواص

کلاس عکس

خواص

مواد و روش ها

کلاس پلاس کد

خواص

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

ثابت ها

مرور کلاس

خواص

رابط SearchByTextRequest

خواص

ثابت های SearchByTextRankPreference

ثابت ها

رابط SearchNearbyRequest

خواص

SearchNearbyRankPreference ثابت

ثابت ها