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

בחירת פלטפורמה: Android iOS JavaScript שירות אינטרנט

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

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

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

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

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

שדה	API של מקומות Google	Library של מקומות, Maps JavaScript API	מקומות SDK ל-Android	SDK של מקומות ל-iOS
רכיבי כתובת	address_components	address_components	Place.Field.ADDRESS_COMPONENTS	GMSPlaceFieldAddressComponents
Address	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	---	---
כניסה נגישה לכיסאות גלגלים	wheelchair_accessible_entrance	---	Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE	GMSPlaceFieldWheelchairAccessibleEntrance

שדות לנתונים של אנשי קשר

שדה	API של מקומות Google	Library של מקומות, 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	---
שעות פתיחה משניות	secondary_opening_hours	---	Place.Field.SECONDARY_OPENING_HOURS	---
אתר	website	website	Place.Field.WEBSITE_URI	GMSPlaceFieldWebsite

שדות נתונים של אטמוספרה

שדה	API של מקומות Google	Library של מקומות, 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	---	---	---
רמת מחירים	price_level	price_level	Place.Field.PRICE_LEVEL	GMSPlaceFieldPriceLevel
Rating	rating	rating	Place.Field.RATING	GMSPlaceFieldRating
ניתן לשימוש חד-פעמי	reservable	---	Place.Field.RESERVABLE	GMSPlaceFieldReservable
ביקורות	reviews	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

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

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

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

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