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

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

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

בחירת פלטפורמה: 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 של מפות JavaScript

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

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

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