שדות נתוני מקום (גרסה קודמת)

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

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

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

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

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

שדות נתונים של 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_COUNT GMSPlaceFieldUserRatingsTotal

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

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

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

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