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

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

מידע נוסף על החיוב על בקשות של פרטי מקום (גרסה קודמת) זמין במאמר בנושא שימוש וחיוב.

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

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

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

שדה	‫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.FORMATTED_ADDRESS	GMSPlaceFieldFormattedAddress
אזור התצוגה	geometry/viewport	geometry.viewport	Place.Field.VIEWPORT	GMSPlaceFieldViewport
מיקום	geometry/location	geometry.location	Place.Field.LOCATION	GMSPlaceFieldCoordinate
סמל	icon	icon	---	---
מזהה URI בסיסי של מסכת סמל	icon_mask_base_uri	icon_mask_base_uri	Place.Field.ICON_MASK_URL	GMSPlaceFieldIconImageURL
צבע רקע של סמל	icon_background_color	icon_background_color	Place.Field.ICON_BACKGROUND_COLOR	GMSPlaceFieldIconBackgroundColor
שם	name	name	Place.Field.DISPLAY_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.ACCESSIBILITY_OPTIONS	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.INTERNATIONAL_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	‫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_COUNT	GMSPlaceFieldUserRatingsTotal

תמיכה בשדות של ספריית מקומות, Maps JavaScript API

כל הבקשות של Find Place (Legacy),‏ Nearby Search (Legacy) ו-Text Search (Legacy) מחזירות קבוצת משנה של השדות שמוחזרים על ידי בקשות של Place Details (Legacy). ה-methods האלה לא מחזירות את השדות הבאים:

• address_component
• adr_address
• formatted_phone_number
• international_phone_number
• opening_hours (לא מוחזר עבור חיפושים של מקומות. לחיפוש בקרבת מקום (גרסה קודמת) ולחיפוש טקסט (גרסה קודמת), משתמשים בפרמטר הבקשה openNow.
• reviews
• takeout
• type
• url
• utc_offset_minutes
• vicinity
• website

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