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

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

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

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

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

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

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

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