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

דף זה תורגם על ידי Cloud Translation API.

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

בחירת פלטפורמה: Android iOS JavaScript Web Service

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

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