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