מבוא
Places API תומך ב-Place Details (מדור ישן). אם אתם מכירים את Places API (מדור ישן), כדאי לדעת שב-Place Details (חדש) בוצעו השינויים הבאים:
- חובה לבצע אנונימיזציה של השדה. צריך לציין אילו שדות רוצים להחזיר בתגובה. אין רשימת ברירת מחדל של שדות שמוחזרים. אם לא מציינים את הרשימה הזו, השיטות מחזירות שגיאה. מידע נוסף זמין במאמר בנושא FieldMask.
- הגרסה החדשה של Place Details תומכת במפתחות API ובאסימוני OAuth כמנגנון אימות.
- רק JSON נתמך כפורמט תגובה ב-Place Details (חדש).
- פורמט התגובה של Places API (חדש) ב-JSON השתנה מהפורמט של ממשקי ה-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 של התשובה.