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

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

בשדות של נתוני מקום מוגדרים הסוגים של נתוני מקום שיוחזרו כשמבקשים את פרטי המקום. בדף זה מפורטים כל השדות של נתוני המקום ומוסבר איך הם נתמכים בכל 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.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

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

שדה	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

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

שדה	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	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

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

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

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