מבוא
Places API תומך ב-Place Details (מדור קודם). אם אתם מכירים את Places API (מדור ישן), כדאי לדעת שב-Place Details (חדש) בוצעו השינויים הבאים:
- חובה לבצע אנונימיזציה של השדה. צריך לציין אילו שדות רוצים לקבל בתשובה. אין רשימת ברירת מחדל של שדות שמוחזרים. אם לא מציינים את הרשימה הזו, השיטות מחזירות שגיאה. מידע נוסף זמין במאמר בנושא FieldMask.
- ה-API החדש של Place Details תומך במפתחות API ובאסימוני OAuth כמנגנון אימות.
- יש תמיכה רק בפורמט JSON כתגובה ב-Place Details (חדש).
- הפורמט של תגובת ה-JSON ב-Places API (חדש) השתנה לעומת הפורמט של ממשקי ה-API מדור קודם. פרטים נוספים מופיעים במאמר העברת התגובה של Places API.
בטבלה הבאה מפורטים פרמטרים ב-Place Details (Legacy) ששמם שונה או שהם שונו ב-Place Details (New), או פרמטרים שכבר לא נתמכים.
| הפרמטר הנוכחי | פרמטר חדש | פתקים |
|---|---|---|
place_id |
places/PLACE_ID |
המחרוזת places/PLACE_ID נקראת גם שם המשאב של המקום. בתשובה לבקשה של Place Details (New), חיפוש בסביבה (New) ו-חיפוש טקסט (New), המחרוזת הזו מופיעה בשדה name של התשובה.
מזהה המקום העצמאי מופיע בשדה id של התשובה. |
language |
languageCode |
|
region |
regionCode |
דוגמה לבקשה
בדוגמה הבאה מוצגת בקשת GET שמשתמשת ב-Place Details (גרסה קודמת). בדוגמה הזו, אתם מבקשים תגובת JSON שמכילה מידע על מזהה מקום ומעבירים את כל הפרמטרים כפרמטרים של כתובת URL. בדוגמה הזו נעשה שימוש גם ב-fields, ולכן התגובה כוללת רק את השם המוצג ואת הכתובת המעוצבת של המקום:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
כשמשתמשים ב-Place Details (חדש), שולחים בקשת GET ומעבירים את כל הפרמטרים בפרמטרים של כתובת ה-URL ובכותרות כחלק מהבקשה. בדוגמה הזו נעשה שימוש גם במסכת שדות, כך שהתשובה כוללת רק את השם המוצג ואת הכתובת המעוצבת של המקום:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
המחרוזת places/PLACE_ID נקראת גם שם המשאב של המקום. בתשובה לבקשה של Place Details (New), חיפוש בסביבה (New) ו-חיפוש טקסט (New), המחרוזת הזו מופיעה בשדה name של התשובה. מזהה המקום העצמאי מופיע בשדה id של התשובה.