שדות של נתוני מקום מגדירים את הסוגים של נתוני מקומות להחזרה שמבקשים עבור פרטי מקומות. בדף הזה מפורטים כל השדות של נתוני המקומות, והסבר על התמיכה בכל ממשקי API/SDK (התמיכה בשדות של מקומות משתנה בהתאם לפלטפורמה או לתכונה).
מידע נוסף על אופן החיוב של בקשות לפרטי מקום זמין במאמר שימוש וחיוב.
בטבלה הבאה מפורטים כל הערכים הנתמכים של שדות נתונים של מקומות, לפי רמת תמחור ופלטפורמה.
נתונים בסיסיים
שדות לנתונים של אנשי קשר
שדה | 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 |
שדות נתונים של אטמוספרה
תמיכה בספריית מקומות, שדות 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
כדי להחזיר אחד או יותר משדות הנתונים האלה לגבי מקום מסוים, שולחים בקשת פרטי מקום, מעבירים מזהה מקום ומציינים אילו שדות יש להחזיר.