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

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

مکان فیلدهای داده

فیلدهای داده مکان، انواع داده‌های مکان را برای بازگرداندن هنگام درخواست جزئیات مکان تعریف می‌کنند. این صفحه همه فیلدهای داده مکان را فهرست می‌کند، و توضیح می‌دهد که چگونه برای هر API/SDK پشتیبانی می‌شوند (پشتیبانی از فیلدهای مکان بسته به پلت فرم و/یا ویژگی متفاوت است).

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

جدول زیر تمام مقادیر فیلد داده مکان پشتیبانی شده را بر اساس ردیف قیمت‌گذاری و پلتفرم فهرست می‌کند.

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

داده های پایه

میدان	Places API	کتابخانه مکان‌ها، Maps JavaScript API	مکان‌های SDK برای Android	مکان‌های SDK برای iOS
اجزای آدرس	`address_components`	`address_components`	`Place.Field.ADDRESS_COMPONENTS`	`GMSPlaceFieldAddressComponents`
آدرس	`adr_address`	`adr_address`	`---`	`---`
وضعیت کسب و کار	`business_status`	`business_status`	`Place.Field.BUSINESS_STATUS`	`GMSPlaceFieldBusinessStatus`
آدرس فرمت شده	`formatted_address`	`formatted_address`	`Place.Field.ADDRESS`	`GMSPlaceFieldFormattedAddress`
درگاه دید	`geometry/viewport`	`geometry.viewport`	`Place.Field.VIEWPORT`	`GMSPlaceFieldViewport`
مکان	`geometry/location`	`geometry.location`	`Place.Field.LAT_LNG`	`GMSPlaceFieldCoordinate`
نماد	`icon`	`icon`	`---`	`---`
Icon Mask Base URI	`icon_mask_base_uri`	`icon_mask_base_uri`	`Place.Field.ICON_URL`	`GMSPlaceFieldIconImageURL`
رنگ پس زمینه نماد	`icon_background_color`	`icon_background_color`	`Place.Field.ICON_BACKGROUND_COLOR`	`GMSPlaceFieldIconBackgroundColor`
نام	`name`	`name`	`Place.Field.NAME`	`GMSPlaceFieldName`
برای همیشه بسته ( منسوخ شده )	`permanently_closed`	`permanently_closed`	`---`	`---`
عکس	`photos`	`photos`	`Place.Field.PHOTO_METADATAS`	`GMSPlaceFieldPhotos`
شناسه مکان	`place_id`	`place_id`	`Place.Field.ID`	`GMSPlaceFieldPlaceID`
کد پلاس	`plus_code`	`plus_code`	`Place.Field.PLUS_CODE`	`GMSPlaceFieldPlusCode`
تایپ کنید	`type`	`type`	`Place.Field.TYPES`	`GMSPlaceFieldTypes`
URL	`url`	`url`	`---`	`---`
افست UTC	`utc_offset`	`utc_offset_minutes`	`Place.Field.UTC_OFFSET`	`GMSPlaceFieldUTCOffsetMinutes`
مجاورت	`vicinity`	`vicinity`	`---`	`---`
ورودی قابل دسترسی با ویلچر	`wheelchair_accessible_entrance`	`---`	`Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE`	`GMSPlaceFieldWheelchairAccessibleEntrance`

فیلدهای اطلاعات تماس

میدان	Places API	کتابخانه مکان‌ها، Maps JavaScript API	مکان‌های SDK برای Android	مکان‌های SDK برای iOS
شماره تلفن	`formatted_phone_number`	`formatted_phone_number`	`---`	`---`
شماره تلفن بین المللی	`international_phone_number`	`international_phone_number`	`Place.Field.PHONE_NUMBER`	`GMSPlaceFieldPhoneNumber`
ساعات کار	`opening_hours`	`opening_hours`	`Place.Field.OPENING_HOURS`	`GMSPlaceFieldOpeningHours`
ساعت کاری فعلی	`current_opening_hours`	`---`	`Place.Field.CURRENT_OPENING_HOURS`	`GMSPlaceFieldCurrentOpeningHours`
ساعات کار ثانویه	`secondary_opening_hours`	`---`	`Place.Field.SECONDARY_OPENING_HOURS`	`GMSPlaceFieldSecondaryOpeningHours`
وب سایت	`website`	`website`	`Place.Field.WEBSITE_URI`	`GMSPlaceFieldWebsite`

فیلدهای داده اتمسفر

میدان	Places API	کتابخانه مکان‌ها، Maps JavaScript API	مکان‌های SDK برای Android	مکان‌های SDK برای iOS
وانت کناری	`curbside_pickup`	`---`	`Place.Field.CURBSIDE_PICKUP`	`GMSPlaceFieldCurbsidePickup`
تحویل	`delivery`	`---`	`Place.Field.DELIVERY`	`GMSPlaceFieldDelivery`
غذا خوردن	`dine_in`	`---`	`Place.Field.DINE_IN`	`GMSPlaceFieldDineIn`
خلاصه سرمقاله	`editorial_summary`	`---`	`Place.Field.EDITORIAL_SUMMARY`	`GMSPlaceFieldEditorialSummary`
سطح قیمت	`price_level`	`price_level`	`Place.Field.PRICE_LEVEL`	`GMSPlaceFieldPriceLevel`
رتبه بندی	`rating`	`rating`	`Place.Field.RATING`	`GMSPlaceFieldRating`
قابل رزرو	`reservable`	`---`	`Place.Field.RESERVABLE`	`GMSPlaceFieldReservable`
بررسی ها	`reviews`	`reviews`	`Place.Field.REVIEWS`	`---`
آبجو سرو می کند	`serves_beer`	`---`	`Place.Field.SERVES_BEER`	`GMSPlaceFieldServesBeer`
صبحانه سرو می کند	`serves_breakfast`	`---`	`Place.Field.SERVES_BREAKFAST`	`GMSPlaceFieldServesBreakfast`
صبحانه سرو می کند	`serves_brunch`	`---`	`Place.Field.SERVES_BRUNCH`	`GMSPlaceFieldServesBrunch`
شام را سرو می کند	`serves_dinner`	`---`	`Place.Field.SERVES_DINNER`	`GMSPlaceFieldServesDinner`
ناهار را سرو می کند	`serves_lunch`	`---`	`Place.Field.SERVES_LUNCH`	`GMSPlaceFieldServesLunch`
غذای گیاهی سرو می کند	`serves_vegetarian_food`	`---`	`Place.Field.SERVES_VEGETARIAN_FOOD`	`GMSPlaceFieldServesVegetarianFood`
شراب سرو می کند	`serves_wine`	`---`	`Place.Field.SERVES_WINE`	`GMSPlaceFieldServesWine`
بیرون‌بر	`takeout`	`---`	`Place.Field.TAKEOUT`	`GMSPlaceFieldTakeout`
مجموع امتیازات کاربران	`user_ratings_total`	`user_ratings_total`	`Place.Field.USER_RATINGS_TOTAL`	`GMSPlaceFieldUserRatingsTotal`

کتابخانه مکان‌ها، زمینه‌های API جاوا اسکریپت Maps را پشتیبانی می‌کند

درخواست‌های Find Place ، Nearby Search و Text Search زیرمجموعه‌ای از فیلدهایی را برمی‌گردانند که توسط درخواست‌های Place Details برگردانده می‌شوند. این متدها فیلدهای زیر را بر نمی گرداند:

address_component
adr_address
formatted_phone_number
international_phone_number
opening_hours (برای هیچ جستجوی مکان برگردانده نشده است. برای جستجوی نزدیک و جستجوی متن، از پارامتر درخواست openNow استفاده کنید.)
reviews
takeout
type
url
utc_offset_minutes
vicinity
website

برای برگرداندن یک یا چند مورد از این فیلدهای داده برای یک مکان، درخواست جزئیات مکان را ارسال کنید، شناسه مکان را ارسال کنید و مشخص کنید کدام فیلدها را بازگردانید.