طراحی نقشه جدید به زودی به پلتفرم نقشه های گوگل ارائه می شود. این به‌روزرسانی برای استایل نقشه شامل یک پالت رنگ پیش‌فرض جدید و بهبودهایی در تجربیات نقشه و قابلیت استفاده است. همه سبک‌های نقشه به‌طور خودکار در مارس 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` .
`editorialSummary`	نوع: `string optional` خلاصه سرمقاله برای این مکان. اگر خلاصه ویرایشی وجود نداشته باشد `null` . اگر این فیلد هنوز درخواست نشده باشد `undefined` .
`editorialSummaryLanguageCode`	نوع: `string optional` زبان خلاصه سرمقاله برای این مکان. اگر خلاصه ویرایشی وجود نداشته باشد `null` . اگر این فیلد هنوز درخواست نشده باشد `undefined` .
`formattedAddress`	نوع: `string optional` آدرس کامل مکان ها
`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`
`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`

رابط FetchFieldsRequest

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

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

خواص
`fields`	نوع: `Array <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 تصویر مربوط به گزینه های مشخص شده را برمی گرداند.

کلاس 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 نمایه نویسنده برای این نتیجه.

کلاس پلاس کد

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 . 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' برچسب گذاری شده اند.

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

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`

رابط SearchByTextRequest

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

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

خواص
`fields`	نوع: `Array <string>` فیلدهایی که باید در پاسخ گنجانده شوند، که برای آن صورت‌حساب دریافت می‌شود . اگر `['*']` وارد شود، همه فیلدهای موجود برگردانده می‌شوند و برای آنها صورت‌حساب دریافت می‌شود (این برای استقرار تولید توصیه نمی‌شود). برای فهرستی از فیلدها `PlaceResult` را ببینید. فیلدهای تودرتو را می توان با مسیرهای نقطه مشخص کرد (به عنوان مثال، `"geometry.location"` ).
`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.DISTANCE` نتایج چگونه در پاسخ رتبه بندی خواهند شد.
`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>` فیلدهایی که باید در پاسخ گنجانده شوند، که برای آن صورت‌حساب دریافت می‌شود . اگر `['*']` وارد شود، همه فیلدهای موجود برگردانده می‌شوند و برای آنها صورت‌حساب دریافت می‌شود (این برای استقرار تولید توصیه نمی‌شود). برای فهرستی از فیلدها `PlaceResult` را ببینید. فیلدهای تودرتو را می توان با مسیرهای نقطه ای مشخص کرد (به عنوان مثال، `"geometry.location"` ).
`locationRestriction`	نوع: `Circle \| CircleLiteral` منطقه مورد جستجو، به عنوان یک دایره با مرکز و شعاع مشخص شده است. نتایج خارج از مکان مشخص شده برگردانده نمی شوند.
`excludedPrimaryTypes 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 ثابت

Enum RankPreference برای SearchNearbyRequest.

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

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

Place

محل کلاس

سازنده

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

خواص

مواد و روش ها

رابط PlaceOptions

خواص

کلاس AccessibilityOptions

خواص

AddressComponent کلاس

خواص

کلاس اسناد

خواص

رابط FetchFieldsRequest

خواص

کلاس OpeningHours

خواص

کلاس OpeningHoursPeriod

خواص

کلاس OpeningHoursPoint

خواص

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

خواص

کلاس PaymentOptions

خواص

کلاس عکس

خواص

مواد و روش ها

کلاس AuthorAttribution

خواص

کلاس پلاس کد

خواص

مرور کلاس

خواص

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

ثابت ها

رابط SearchByTextRequest

خواص

ثابت های SearchByTextRankPreference

ثابت ها

رابط SearchNearbyRequest

خواص

SearchNearbyRankPreference ثابت

ثابت ها