שדות של נתוני מקום

שדות של נתוני מקום מגדירים את סוגי נתוני המקום שיוחזר כשמבקשים את פרטי המקום. בדף הזה מפורטים כל שדות הנתונים של המקומות, ומוסבר איך הם נתמכים בכל ממשק API או SDK (התמיכה בשדות של מקומות משתנה בהתאם לפלטפורמה ו/או לתכונה).

למידע נוסף על החיוב על בקשות לקבלת פרטי מקומות, קראו את המאמר שימוש וחיובים.

בטבלה הבאה מפורטים כל הערכים הנתמכים של שדות נתוני המיקום לפי רמת התמחור והפלטפורמה.

נתונים בסיסיים

שדה	Places API	ספריית מקומות, Maps JavaScript API	Places SDK ל-Android	Places 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	---	---
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	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	vicinity	---	---
כניסה נגישה לכיסאות גלגלים	wheelchair_accessible_entrance	---	Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE	GMSPlaceFieldWheelchairAccessibleEntrance

שדות של פרטי איש קשר

שדה	Places API	ספריית מקומות, Maps JavaScript API	Places SDK ל-Android	Places 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

שדות נתונים של Atmosphere

שדה	Places API	ספריית מקומות, Maps JavaScript API	Places SDK ל-Android	Places 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	takeout	---	Place.Field.TAKEOUT	GMSPlaceFieldTakeout
סה"כ דירוגי משתמשים	user_ratings_total	user_ratings_total	Place.Field.USER_RATINGS_TOTAL	GMSPlaceFieldUserRatingsTotal

תמיכה בשדות של Places API

הבקשות חיפוש מקום, חיפוש בקרבת מקום וחיפוש טקסט מחזירות קבוצת משנה של השדות שמוחזרים על ידי בקשות לפרטים על מקומות. השיטות האלה לא מחזירות את השדות הבאים:

address_component adr_address curbside_pickup current_opening_hours delivery dine_in editorial_summary formatted_phone_number international_phone_number opening_hours.periods opening_hours.special_days opening_hours.type opening_hours.weekday_text reservable secondary_opening_hours reviews

serves_beer serves_breakfast serves_brunch serves_dinner serves_lunch serves_vegetarian_food serves_wine takeout type url user_ratings_total utc_offset_minutes vicinity website wheelchair_accessible_entrance

כדי להציג אחד או יותר משדות הנתונים האלה של מקום מסוים, שולחים בקשה לפרטי מקום, מעבירים מזהה מקום ומציינים אילו שדות להציג.