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

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

Place (beta)

محل کلاس

google.maps.places . Place کلاس

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

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

روش های استاتیک
`findPlaceFromPhoneNumber`	توجه: فقط در کانال v=beta موجود است. `findPlaceFromPhoneNumber(request)` مولفه های: `request` : `FindPlaceFromPhoneNumberRequest` درخواستی که شامل شماره تلفن و فیلدهای درخواستی است. مقدار بازگشتی: `Promise <{places: Array < Place >}>` مکان را بر اساس شماره تلفن داده شده جستجو می کند. به دلیل موارد نادری که ممکن است چندین مکان شماره تلفن مشترکی داشته باشند، آرایه‌ای را برمی‌گرداند.
`findPlaceFromQuery`	توجه: فقط در کانال v=beta موجود است. `findPlaceFromQuery(request)` مولفه های: `request` : `FindPlaceFromQueryRequest` درخواستی که شامل پرس و جو متن و فیلدهای درخواستی است. مقدار بازگشتی: `Promise <{places: Array < Place >}>` مکان را بر اساس عبارت متنی داده شده جستجو می کند. به دلیل مواردی که پرس و جو کمی مبهم است و بیش از یک مکان برگردانده می شود، آرایه ای را برمی گرداند. این روش برای جستجوهایی در نظر گرفته نشده است که در آن چندین نتیجه مورد انتظار است.

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

findPlaceFromPhoneNumber

findPlaceFromPhoneNumber(request)

مولفه های:

request : FindPlaceFromPhoneNumberRequest درخواستی که شامل شماره تلفن و فیلدهای درخواستی است.

مقدار بازگشتی: Promise <{places: Array < Place >}>

مکان را بر اساس شماره تلفن داده شده جستجو می کند. به دلیل موارد نادری که ممکن است چندین مکان شماره تلفن مشترکی داشته باشند، آرایه‌ای را برمی‌گرداند.

findPlaceFromQuery

findPlaceFromQuery(request)

مولفه های:

request : FindPlaceFromQueryRequest درخواستی که شامل پرس و جو متن و فیلدهای درخواستی است.

مقدار بازگشتی: Promise <{places: Array < Place >}>

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

خواص
`addressComponents`	نوع: `Array < AddressComponent > optional` مجموعه اجزای آدرس برای مکان این مکان. اگر داده آدرس مشخصی وجود ندارد، شی را خالی کنید. اگر داده های آدرس از سرور فراخوانی نشده باشد، `undefined` .
`adrFormatAddress`	نوع: `string optional` نمایش آدرس مکان در میکروفرمت adr .
`attributions`	نوع: `Array < Attribution > optional` متن انتساب برای این نتیجه مکان نمایش داده شود.
`businessStatus`	نوع: `BusinessStatus optional` وضعیت عملیاتی مکان اگر وضعیت شناخته شده ای وجود نداشته باشد، `null` . اگر داده های وضعیت از سرور بارگیری نشده باشد، `undefined` .
`displayName`	نوع: `string optional` نام نمایشی مکان اگر نامی وجود نداشته باشد، `null` . اگر داده های نام از سرور بارگیری نشده باشد، `undefined` .
`formattedAddress`	نوع: `string optional` آدرس کامل مکان ها
`googleMapsURI`	نوع: `string optional` URL صفحه رسمی گوگل برای این مکان. این صفحه متعلق به Google است که حاوی بهترین اطلاعات موجود در مورد مکان است.
`hasCurbsidePickup`	نوع: `boolean optional` اینکه آیا مکانی دارای وانت کنار خیابان است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`hasDelivery`	نوع: `boolean optional` اینکه آیا مکانی تحویل دارد یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`hasDineIn`	نوع: `boolean optional` اینکه آیا مکانی غذاخوری دارد یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`hasTakeout`	نوع: `boolean optional` اینکه آیا مکانی دارای بیرون‌بر است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`hasWheelchairAccessibleEntrance`	نوع: `boolean optional` آیا مکانی دارای ورودی قابل دسترسی با صندلی چرخدار است یا خیر. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`iconBackgroundColor`	نوع: `string optional` کد رنگ HEX پیش‌فرض برای دسته مکان.
`id`	نوع: `string` شناسه مکان منحصر به فرد
`internationalPhoneNumber`	نوع: `string optional` شماره تلفن مکان در قالب بین المللی. قالب بین المللی شامل کد کشور است و با علامت مثبت (+) پیشوند است.
`isReservable`	نوع: `boolean optional` اینکه آیا یک مکان قابل رزرو است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`location`	نوع: `LatLng optional` موقعیت مکان
`nationalPhoneNumber`	نوع: `string optional` شماره تلفن مکان، که بر اساس کنوانسیون منطقه‌ای شماره قالب‌بندی شده است.
`openingHours`	نوع: `OpeningHours optional`
`photos`	نوع: `Array < Photo > optional` عکس های این مکان این مجموعه شامل حداکثر ده شیء `Photo` است.
`plusCode`	نوع: `PlusCode optional`
`priceLevel`	نوع: `PriceLevel optional` سطح قیمت مکان. این ویژگی می تواند هر یک از مقادیر زیر را برگرداند `Free` `Inexpensive` `Moderate` `Expensive` `Very Expensive`
`rating`	نوع: `number optional` امتیازی بین 1.0 تا 5.0 بر اساس نظرات کاربران از این مکان.
`requestedLanguage`	نوع: `string optional` زبان درخواستی برای این مکان.
`requestedRegion`	نوع: `string optional` منطقه درخواستی برای این مکان.
`reviews`	نوع: `Array < Review > optional` فهرستی از نظرات برای این مکان.
`servesBeer`	نوع: `boolean optional` این که آیا در مکانی آبجو سرو می شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`servesBreakfast`	نوع: `boolean optional` این که آیا یک مکان صبحانه سرو می کند. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`servesBrunch`	نوع: `boolean optional` این که آیا در مکانی برانچ سرو می شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار ناشناخته باشد، "null" را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «تعریف نشده» را برمی‌گرداند.
`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` وب سایت معتبر برای این مکان، مانند صفحه اصلی یک کسب و کار.

مواد و روش ها
`fetchFields`	توجه: فقط در کانال v=beta موجود است. `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" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی").

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>` لیست فیلدهایی که باید واکشی شوند.
`sessionToken optional`	نوع: `AutocompleteSessionToken optional` مرجع منحصر به فرد مورد استفاده برای بسته بندی درخواست جزئیات با یک جلسه تکمیل خودکار.

کلاس 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 . 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`

Place (beta)

محل کلاس

سازنده

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

خواص

مواد و روش ها

رابط PlaceOptions

خواص

AddressComponent کلاس

خواص

کلاس اسناد

خواص

رابط FetchFieldsRequest

خواص

کلاس OpeningHours

خواص

کلاس OpeningHoursPeriod

خواص

کلاس OpeningHoursPoint

خواص

کلاس عکس

خواص

مواد و روش ها

کلاس AuthorAttribution

خواص

کلاس پلاس کد

خواص

مرور کلاس

خواص

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

ثابت ها