Place Data

کلاس مکان

‫google.maps.places.Place کلاس

این کلاس PlaceOptions را پیاده‌سازی می‌کند.

با تماس با 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 اگر داده‌های وضعیت از سرور بار نشده باشد.
consumerAlert	نوع:  ConsumerAlert optional هشدار مصرف‌کننده برای این مکان.
displayName	نوع:  string optional نام نمایشی مکان. null اگر نامی وجود ندارد. undefined اگر داده‌های نام از سرور بار نشده باشد.
displayNameLanguageCode	نوع:  string optional زبان نام نمایشی مکان. null اگر نامی وجود ندارد. undefined اگر داده‌های نام از سرور بار نشده باشد.
editorialSummary	نوع:  string optional خلاصه سردبیری برای این مکان. null اگر خلاصه نویسندگان وجود نداشته باشد. undefined اگر این فیلد هنوز درخواست نشده است.
editorialSummaryLanguageCode	نوع:  string optional زبان خلاصه سردبیری برای این مکان. null اگر خلاصه نویسندگان وجود نداشته باشد. undefined اگر این فیلد هنوز درخواست نشده است.
evChargeAmenitySummary	نوع:  EVChargeAmenitySummary optional EVChargeAmenitySummary برای این مکان.
evChargeOptions	نوع:  EVChargeOptions optional گزینه‌های شارژ خودرو برقی که این مکان ارائه می‌دهد. undefined اگر گزینه‌های شارژ خودرو برقی از سرور فراخوانی نشده باشد.
formattedAddress	نوع:  string optional نشانی کامل مکان.
fuelOptions	نوع:  FuelOptions optional گزینه‌های سوخت ارائه‌شده توسط مکان. undefined اگر گزینه‌های سوخت از سرور فراخوانی نشده باشد.
generativeSummary	نوع:  GenerativeSummary optional GenerativeSummary برای این مکان.
googleMapsLinks	نوع:  GoogleMapsLinks optional پیوندهایی برای راه‌اندازی کنش‌های مختلف Google Maps.
googleMapsURI	نوع:  string optional نشانی وب صفحه رسمی Google برای این مکان. این صفحه متعلق به Google است که حاوی بهترین اطلاعات موجود درباره «مکان» است.
hasCurbsidePickup	نوع:  boolean optional اینکه مکانی تحویل در خیابان دارد یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
hasDelivery	نوع:  boolean optional اینکه مکانی خدمات ارسال دارد یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
hasDineIn	نوع:  boolean optional آیا مکانی صرف غذا در محل دارد. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
hasLiveMusic	نوع:  boolean optional
hasMenuForChildren	نوع:  boolean optional
hasOutdoorSeating	نوع:  boolean optional
hasRestroom	نوع:  boolean optional
hasTakeout	نوع:  boolean optional اینکه مکانی بیرون‌بر دارد یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
iconBackgroundColor	نوع:  string optional کد رنگ HEX پیش‌فرض برای دسته مکان.
id	نوع:  string شناسه یکتای مکان.
internationalPhoneNumber	نوع:  string optional شماره تلفن مکان در قالب بین‌المللی. قالب بین‌المللی شامل کد کشور است و پیشوند آن علامت به‌علاوه (+) است.
isGoodForChildren	نوع:  boolean optional
isGoodForGroups	نوع:  boolean optional
isGoodForWatchingSports	نوع:  boolean optional
isReservable	نوع:  boolean optional آیا مکان قابل‌رزرو است. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
location	نوع:  LatLng optional موقعیت «مکان».
nationalPhoneNumber	نوع:  string optional شماره تلفن مکان، قالب‌بندی‌شده طبق قرارداد منطقه‌ای شماره.
neighborhoodSummary	نوع:  NeighborhoodSummary optional NeighborhoodSummary برای این مکان.
parkingOptions	نوع:  ParkingOptions optional گزینه‌های پارکینگ ارائه‌شده توسط مکان. undefined اگر داده‌های گزینه‌های پارکینگ از سرور فراخوانی نشده باشد.
paymentOptions	نوع:  PaymentOptions optional گزینه‌های پرداخت ارائه‌شده توسط مکان. undefined اگر داده‌های گزینه‌های پرداخت از سرور فراخوانی نشده باشد.
photos	نوع:  Array<Photo> optional عکس‌های این مکان. این مجموعه حداکثر ده شیء Photo خواهد داشت.
plusCode	نوع:  PlusCode optional
postalAddress	نوع:  PostalAddress optional
priceLevel	نوع:  PriceLevel optional سطح قیمت «مکان». این خصوصیت می‌تواند هریک از مقادیر زیر را برگرداند Free Inexpensive Moderate Expensive Very Expensive
priceRange	نوع:  PriceRange optional محدوده قیمت برای این «مکان». endPrice ممکن است تنظیم نشده باشد که نشان‌دهنده محدوده‌ای بدون حد بالا است (مثلاً «بیش‌از ۱۰۰ دلار»).
primaryType	نوع:  string optional نوع اصلی مکان. null اگر نوعی وجود نداشته باشد. undefined اگر داده‌های نوع از سرور بار نشده باشد.
primaryTypeDisplayName	نوع:  string optional نام نمایشی نوع اصلی مکان. null اگر نوعی وجود نداشته باشد. undefined اگر داده‌های نوع از سرور بار نشده باشد.
primaryTypeDisplayNameLanguageCode	نوع:  string optional زبان نام نمایشی نوع اصلی مکان. null اگر نوعی وجود نداشته باشد. undefined اگر داده‌های نوع از سرور بار نشده باشد.
rating	نوع:  number optional رده‌بندی بین ۱٫۰ تا ۵٫۰ براساس مرورهای کاربران از این «مکان».
regularOpeningHours	نوع:  OpeningHours optional
requestedLanguage	نوع:  string optional زبان درخواست‌شده برای این مکان.
requestedRegion	نوع:  string optional منطقه درخواست‌شده برای این مکان.
resourceName	نوع:  string نام منبع مکان غیرتکراری.
reviews	نوع:  Array<Review> optional فهرستی از مرورهای این «مکان».
reviewSummary	نوع:  ReviewSummary optional ReviewSummary برای این مکان.
servesBeer	نوع:  boolean optional آیا مکانی آبجو سرو می‌کند یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
servesBreakfast	نوع:  boolean optional آیا مکانی صبحانه سرو می‌کند یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
servesBrunch	نوع:  boolean optional اینکه مکانی چاشت نیمروز سرو می‌کند یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
servesCocktails	نوع:  boolean optional
servesCoffee	نوع:  boolean optional
servesDessert	نوع:  boolean optional
servesDinner	نوع:  boolean optional آیا مکانی شام سرو می‌کند یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
servesLunch	نوع:  boolean optional آیا مکانی ناهار سرو می‌کند. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
servesVegetarianFood	نوع:  boolean optional آیا مکانی غذای گیاهی سرو می‌کند یا نه. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
servesWine	نوع:  boolean optional آیا در این مکان شراب سرو می‌شود. اگر مقدار مشخص باشد، «درست» یا «نادرست» را برمی‌گرداند. اگر مقدار نامشخص باشد، «null» را برمی‌گرداند. اگر این فیلد هنوز درخواست نشده باشد، «undefined» را برمی‌گرداند.
shortFormattedAddress	نوع:  string optional نشانی کوتاه مکان.
subDestinations	نوع:  Array<Place> optional فهرست زیرمقصدها برای این مکان. زیرمقصدها مکان‌های خاصی هستند که با مکان اصلی مرتبط‌اند. این ویژگی مقصدهای خاص‌تری را برای کاربرانی که درحال جستجو در مکانی بزرگ یا پیچیده مانند فرودگاه، پارک ملی، دانشگاه، یا استادیوم هستند ارائه می‌دهد.
svgIconMaskURI	نوع:  string optional نشانی وب منبع ماسک تصویر svg که می‌تواند برای نمایش دسته مکان استفاده شود.
types	نوع:  Array<string> optional آرایه‌ای از انواع این «مکان» (برای مثال، ["political", "locality"] یا ["restaurant", "establishment"]).
userRatingCount	نوع:  number optional تعداد رده‌بندی‌های کاربر که در Place.rating این مکان نقش داشته است.
utcOffsetMinutes	نوع:  number optional انحراف از UTC منطقه زمانی فعلی «مکان»، برحسب دقیقه. برای مثال، زمان استاندارد شرق استرالیا (GMT+10) در ساعت تابستانی ۱۱ ساعت جلوتر از ساعت هماهنگ جهانی است، بنابراین utc_offset_minutes به 660 تبدیل می‌شود. برای مناطق زمانی عقب‌تر از ساعت هماهنگ جهانی، اختلاف منفی است. برای مثال، utc_offset_minutes برای کیپ ورد -60 است.
viewport	نوع:  LatLngBounds optional ناحیه نمایش ترجیحی هنگام نمایش این «مکان» روی نقشه.
websiteURI	نوع:  string optional وب‌سایت معتبر برای این «مکان»، مثل صفحه اصلی کسب‌وکار.
openingHours	منسوخ‌شده: به‌جای آن از Place.regularOpeningHours استفاده کنید. نوع:  OpeningHours optional
hasWiFi	منسوخ‌شده: این فیلد به‌طور تصادفی مستند شده است، اما درواقع هرگز درج نشده است. نوع:  boolean optional

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

میانای PlaceOptions

میانا google.maps.places.PlaceOptions

گزینه‌های ساختن «مکان».

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

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

اطلاعات مربوط به ارائه‌دهنده داده برای «مکان».

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

مشخصات
provider	نوع:  string optional نام ارائه‌دهنده داده‌های «مکان».
providerURI	نوع:  string optional URI به ارائه‌دهنده داده‌های «مکان».

AuthorAttribution کلاس

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

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

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

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

کلاس ConnectorAggregation

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

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

با تماس با 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 نوع رابط این انبوهش.

کلاس ConsumerAlert

‫google.maps.places.ConsumerAlert کلاس

پیام هشدار مصرف‌کنندگان. همه نوشتارها به زبانی که در فیلد languageCode مشخص شده است ارائه می‌شوند.

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

مشخصات
details	نوع:  ConsumerAlertDetails optional جزئیات پیام هشدار مصرف‌کننده.
languageCode	نوع:  string optional کد زبان پیام هشدار مصرف‌کننده.
overview	نوع:  string optional نمای کلی پیام هشدار مصرف‌کننده.

ConsumerAlertDetails کلاس

‫google.maps.places.ConsumerAlertDetails کلاس

جزئیات پیام هشدار مصرف‌کننده.

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

مشخصات
aboutLinkTitle	نوع:  string optional عنوانی که برای پیوند ارائه اطلاعات بیشتر نشان داده می‌شود.
aboutLinkURI	نوع:  string optional شناسه منبع یکسان برای پیوندی که اطلاعات بیشتری ارائه می‌دهد.
description	نوع:  string optional شرح پیام هشدار مصرف‌کننده.
title	نوع:  string optional عنوانی که باید همراه با شرح مفصل نشان داده شود.

کلاس ContentBlock

‫google.maps.places.ContentBlock کلاس

ContentBlock محتوای خلاصه و منبع آن را توصیف می‌کند.

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

مشخصات
content	نوع:  string optional محتوای مرتبط با موضوع.
contentLanguageCode	نوع:  string optional کد زبان محتوا.
referencedPlaces	نوع:  Array<Place> فهرستی از Placeهای ارجاع‌شده. وقتی برای اولین‌بار بازیابی می‌شود، هر «مکان» فقط حاوی یک شناسه مکان در فیلد id است.

EVChargeAmenitySummary کلاس

‫google.maps.places.EVChargeAmenitySummary کلاس

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

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

مشخصات
coffee	نوع:  ContentBlock optional خلاصه‌ای از گزینه‌های قهوه در اطراف.
disclosureText	نوع:  string optional نوشتار مربوط به شفاف‌سازی مرتبط با این خلاصه.
disclosureTextLanguageCode	نوع:  string optional کد زبان نوشتار شفاف‌سازی.
flagContentURI	نوع:  string optional شناسه منبع یکسان برای گزارش کردن مشکل خلاصه.
overview	نوع:  ContentBlock optional نمای کلی امکانات رفاهی دردسترس.
restaurant	نوع:  ContentBlock optional خلاصه‌ای از رستوران‌های اطراف.
store	نوع:  ContentBlock optional خلاصه‌ای از فروشگاه‌های اطراف.

کلاس EVChargeOptions

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

اطلاعات مربوط به ایستگاه شارژ خودرو برقی که در این مکان قرار دارد.

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

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

ثابت‌های EVConnectorType

google.maps.places.EVConnectorType یادآور همیشگی

انواع رابط‌های شارژ خودرو برقی.

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

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

میانای EVSearchOptions

میانا google.maps.places.EVSearchOptions

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

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

میانای FetchFieldsRequest

میانا google.maps.places.FetchFieldsRequest

گزینه‌های واکشی فیلدهای «مکان».

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

FuelOptions class

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

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

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

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

کلاس FuelPrice

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

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

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

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

ثابت‌های FuelType

google.maps.places.FuelType یادآور همیشگی

انواع سوخت.

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

ثابت‌ها
BIO_DIESEL	بیودیزل.
DIESEL	سوخت دیزل.
DIESEL_PLUS	سوخت دیزل پلاس.
E100	E 100.
E80	E 80.
E85	E 85.
LPG	LPG.
METHANE	متان.
MIDGRADE	متوسط.
PREMIUM	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	گازوئیل کامیون.

GenerativeSummary class

‫google.maps.places.GenerativeSummary کلاس

خلاصه تولیدشده با هوش مصنوعی برای این مکان.

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

مشخصات
disclosureText	نوع:  string optional نوشتار مربوط به شفاف‌سازی مرتبط با این خلاصه.
disclosureTextLanguageCode	نوع:  string optional کد زبان نوشتار شفاف‌سازی.
flagContentURI	نوع:  string optional شناسه منبع یکسان برای گزارش کردن مشکل خلاصه.
overview	نوع:  string optional نمای کلی مکان.
overviewLanguageCode	نوع:  string optional کد زبان نمای کلی.

کلاس GoogleMapsLinks

‫google.maps.places.GoogleMapsLinks کلاس

پیوندهایی برای راه‌اندازی کنش‌های مختلف Google Maps.

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

مشخصات
directionsURI	نوع:  string optional پیوندی برای نشان دادن مسیرهای رسیدن به مکان در Google Maps. پیوند فقط مکان مقصد را پر می‌کند و از حالت سفر پیش‌فرض DRIVE استفاده می‌کند.
photosURI	نوع:  string optional پیوندی برای نمایش عکس‌های مکان در Google Maps.
placeURI	نوع:  string optional پیوندی برای نشان دادن مکان در Google Maps.
reviewsURI	نوع:  string optional پیوندی برای نمایش مرورهای مکان در Google Maps.
writeAReviewURI	نوع:  string optional پیوندی برای نوشتن مرور برای مکان در Google Maps.

کلاس پول

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

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

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

مشخصات
currencyCode	نوع:  string کد ارز سه‌حرفی، تعریف‌شده در ISO 4217.
nanos	نوع:  number تعداد واحدهای نانو (۱۰^-۹) مبلغ.
units	نوع:  number واحدهای کامل مبلغ. برای مثال، اگر Money.currencyCode «USD» باشد، ۱ واحد برابر با ۱ دلار امریکا است.

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

NeighborhoodSummary class

‫google.maps.places.NeighborhoodSummary کلاس

خلاصه تولیدشده با هوش مصنوعی از مکان‌های جالب نزدیک به آن جا.

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

مشخصات
description	نوع:  ContentBlock optional شرح مفصلی از محله.
disclosureText	نوع:  string optional نوشتار مربوط به شفاف‌سازی مرتبط با این خلاصه.
disclosureTextLanguageCode	نوع:  string optional کد زبان نوشتار شفاف‌سازی.
flagContentURI	نوع:  string optional شناسه منبع یکسان برای گزارش کردن مشکل خلاصه.
overview	نوع:  ContentBlock optional نمای کلی محله.

OpeningHours کلاس

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

اطلاعات مربوط به ساعت کاری «مکان».

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

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

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

نقطه‌ای که وضعیت باز بودن «مکان» تغییر می‌کند.

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

مشخصات
day	نوع:  number روز هفته، به‌صورت عددی در محدوده [۰، ۶]، که از یکشنبه شروع می‌شود. برای مثال، ۲ یعنی سه‌شنبه.
hour	نوع:  number ساعت OpeningHoursPoint.time به‌صورت عدد، در محدوده [۰، ۲۳]. این مورد در منطقه زمانی «مکان» گزارش خواهد شد.
minute	نوع:  number دقیقه OpeningHoursPoint.time به‌صورت عدد، در محدوده [۰، ۵۹]. این مورد در منطقه زمانی «مکان» گزارش خواهد شد.

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

با تماس با 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 کلاس

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

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

مشخصات
authorAttributions	نوع:  Array<AuthorAttribution> نوشتار انتساب برای نمایش در این عکس.
flagContentURI	نوع:  string optional پیوندی که کاربر می‌تواند ازطریق آن مشکلی را در عکس پرچم‌گذاری کند.
googleMapsURI	نوع:  string optional پیوندی برای نمایش عکس در Google Maps.
heightPx	نوع:  number ارتفاع عکس به پیکسل.
widthPx	نوع:  number عرض عکس به پیکسل.

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

کلاس PlusCode

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

Plus code برای مکان. برای اطلاعات بیشتر، به https://plus.codes/ مراجعه کنید.

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

مشخصات
compoundCode	نوع:  string optional کد پلاس با مساحت ۱/۸۰۰۰ درجه در ۱/۸۰۰۰ درجه که چهار نویسه اول (پیش‌شماره) حذف شده و با شرح محل جایگزین شده است. برای مثال، «9G8F+5W زوریخ، سوئیس».
globalCode	نوع:  string optional یک plus code با مساحت ۱/۸۰۰۰ درجه در ۱/۸۰۰۰ درجه. برای مثال، «8FVC9G8F+5W».

کلاس PostalAddress

‫google.maps.places.PostalAddress کلاس

نشان‌دهنده نشانی پستی است (مثلاً برای سرویس پستی برای تحویل موارد). توجه: PostalAddress توسط JavaScript API برای نمونه‌سازی اشیایی که داده‌های برگردانده‌شده توسط «سرویس وب» را نشان می‌دهند استفاده می‌شود.

این کلاس PostalAddressLiteral را پیاده‌سازی می‌کند.

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

مشخصات
addressLines	نوع:  Array<string> خطوط نشانی بدون ساختار که سطوح پایین‌تر نشانی را توصیف می‌کند.
administrativeArea	نوع:  string optional بالاترین بخش اداری که برای نشانی‌های پستی کشور یا منطقه استفاده می‌شود.
languageCode	نوع:  string optional کد زبان BCP-47 محتوای این نشانی. مثال: «zh-Hant»،‏ «ja»،‏ «ja-Latn»،‏ «en».
locality	نوع:  string optional عموماً به بخش شهر/شهرک نشانی اشاره دارد.
organization	نوع:  string optional نام سازمان در نشانی.
postalCode	نوع:  string optional کد پستی نشانی.
recipients	نوع:  Array<string> گیرنده در نشانی.
regionCode	نوع:  string کد منطقه CLDR کشور/منطقه نشانی. مثال: «CH» برای سوئیس. برای جزئیات، به https://cldr.unicode.org/ و https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html مراجعه کنید.
sortingCode	نوع:  string optional کد مرتب‌سازی نشانی.
sublocality	نوع:  string optional زیرمنطقه نشانی، مثل محله، بخش، یا منطقه.

میانای PostalAddressLiteral

میانا google.maps.places.PostalAddressLiteral

داده‌های مربوط به تکمیل PostalAddress.

مشخصات
regionCode	نوع:  string PostalAddress.regionCode را ببینید.
addressLines optional	نوع:  Iterable<string> optional PostalAddress.addressLines را ببینید.
administrativeArea optional	نوع:  string optional PostalAddress.administrativeArea را ببینید.
languageCode optional	نوع:  string optional PostalAddress.languageCode را ببینید.
locality optional	نوع:  string optional PostalAddress.locality را ببینید.
organization optional	نوع:  string optional PostalAddress.organization را ببینید.
postalCode optional	نوع:  string optional PostalAddress.postalCode را ببینید.
recipients optional	نوع:  Iterable<string> optional PostalAddress.recipients را ببینید.
sortingCode optional	نوع:  string optional PostalAddress.sortingCode را ببینید.
sublocality optional	نوع:  string optional PostalAddress.sublocality را ببینید.

ثابت‌های PriceLevel

google.maps.places.PriceLevel یادآور همیشگی

سطح قیمت برای «مکان».

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

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

کلاس PriceRange

‫google.maps.places.PriceRange کلاس

محدوده قیمت مرتبط با «مکان». endPrice ممکن است تنظیم نشده باشد که نشان‌دهنده محدوده‌ای بدون حد بالا است (مثلاً «بیش‌از ۱۰۰ دلار»).

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

مشخصات
endPrice	نوع:  Money optional حد بالای محدوده قیمت (شامل). قیمت باید کمتر از این مقدار باشد.
startPrice	نوع:  Money پایین‌ترین حد محدوده قیمت (فراگیر). قیمت باید برابر یا بیشتر از این مقدار باشد.

مرور کلاس

‫google.maps.places.Review کلاس

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

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

مشخصات
authorAttribution	نوع:  AuthorAttribution optional مرورکننده.
flagContentURI	نوع:  string optional پیوندی که کاربر می‌تواند ازطریق آن مشکل مربوط به مرور را پرچم‌گذاری کند.
googleMapsURI	نوع:  string optional پیوندی برای نشان دادن مرور در Google Maps.
originalText	نوع:  string optional نوشتار مرور به زبان اصلی آن.
originalTextLanguageCode	نوع:  string optional کد زبان IETF که زبان اصلی مرور را نشان می‌دهد.
publishTime	نوع:  Date optional
rating	نوع:  number optional رده‌بندی این مرور، عددی بین ۱٫۰ و ۵٫۰ (شامل این دو عدد).
relativePublishTimeDescription	نوع:  string optional رشته‌ای از زمان اخیر قالب‌بندی‌شده که زمان مرور را نسبت به زمان فعلی در قالبی مناسب برای زبان و کشور بیان می‌کند. برای مثال «یک ماه پیش».
text	نوع:  string optional نوشتار بومی‌سازی‌شده مرور.
textLanguageCode	نوع:  string optional کد زبان IETF که زبان بومی‌سازی‌شده مرور را نشان می‌دهد.
visitDateMonth	نوع:  number optional ماه تاریخی که نویسنده مرور از مکان بازدید کرده است. این فیلد مبتنی بر صفر است؛ ۰ ژانویه است و ۱۱ دسامبر.
visitDateYear	نوع:  number optional سال تاریخی که نویسنده مرور از مکان بازدید کرده است.

ReviewSummary کلاس

‫google.maps.places.ReviewSummary کلاس

خلاصه هوشواره‌ای از مرورهای کاربر درباره مکان.

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

مشخصات
disclosureText	نوع:  string optional نوشتار مربوط به شفاف‌سازی مرتبط با این خلاصه.
disclosureTextLanguageCode	نوع:  string optional کد زبان نوشتار شفاف‌سازی.
flagContentURI	نوع:  string optional شناسه منبع یکسان برای گزارش کردن مشکل خلاصه.
reviewsURI	نوع:  string optional شناسه منبع یکسان برای نمایش مرورهای این مکان در Google Maps.
text	نوع:  string optional خلاصه مرورهای کاربر.
textLanguageCode	نوع:  string optional کد زبان خلاصه مرورهای کاربر.

میانای SearchByTextRequest

میانا google.maps.places.SearchByTextRequest

درخواست میانای Place.searchByText.

مشخصات
fields	نوع:  Array<string> فیلدهایی که باید در پاسخ گنجانده شوند، که برای آن‌ها صورت‌حساب صادر خواهد شد. اگر ['*'] وارد شود، همه فیلدهای دردسترس برگردانده می‌شوند و صورت‌حساب برای آن‌ها صادر می‌شود (این کار برای استقرار تولید توصیه نمی‌شود). می‌توانید هر ویژگی‌ای را در کلاس Place به‌عنوان فیلد درخواست کنید.
evSearchOptions optional	نوع:  EVSearchOptions optional گزینه‌های مربوط به خودرو برقی که می‌توان برای درخواست جستجوی مکان مشخص کرد.
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 تنظیم شود.
locationRestriction optional	نوع:  LatLngBounds|LatLngBoundsLiteral optional منطقه موردنظر برای جستجو. این مکان به‌عنوان محدودیت عمل می‌کند، یعنی نتایج خارج از مکان ارائه‌شده برگردانده نخواهد شد. نمی‌تواند همراه با locationBias تنظیم شود.
maxResultCount optional	نوع:  number optional حداکثر تعداد نتایج برای برگرداندن. باید بین ۱ تا ۲۰ باشد.
minRating optional	نوع:  number optional نتایجی را که میانگین رده‌بندی کاربر آن‌ها دقیقاً کمتر از این حد است فیلتر کنید. مقدار معتبر باید عدد اعشاری بین ۰ و ۵ (شامل این دو عدد) با آهنگ ۰٫۵ باشد، یعنی [۰، ۰٫۵، ۱٫۰، ...، ۵٫۰] شامل این دو عدد. رتبه‌بندی ورودی به نزدیک‌ترین ۰٫۵(سقف) گرد می‌شود. برای مثال، رده‌بندی ۰٫۶ همه نتایج با رده‌بندی کمتر از ۱٫۰ را حذف می‌کند.
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 مراجعه کنید. توجه داشته باشید که کدهای منطقه ۳ رقمی درحال‌حاضر پشتیبانی نمی‌شوند.
textQuery optional	نوع:  string optional وقتی از SearchByTextRequest.query استفاده نمی‌کنید الزامی است. پُرسمان نوشتاری برای جستجوی نوشتاری.
useStrictTypeFiltering optional	نوع:  boolean optional پیش‌فرض: false برای تنظیم فیلتر کردن نوع دقیق برای SearchByTextRequest.includedType استفاده می‌شود. اگر روی «درست» تنظیم شود، فقط نتایج از همان نوع برگردانده می‌شود.

ثابت‌های SearchByTextRankPreference

google.maps.places.SearchByTextRankPreference یادآور همیشگی

RankPreference enum for SearchByTextRequest.

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

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

میانای SearchNearbyRequest

میانا google.maps.places.SearchNearbyRequest

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

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

ثابت‌های SearchNearbyRankPreference

google.maps.places.SearchNearbyRankPreference یادآور همیشگی

RankPreference enum for SearchNearbyRequest.

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

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