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

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

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

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

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

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

שדה	Places API (ממשק 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 (ממשק 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 (ממשק 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

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

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

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

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