מבוא
Places API תומך ב-Place Details (קודם). אם אתם מכירים את Places API (קודם), Place Details (חדש) כולל את השינויים הבאים:
- חובה לבצע אנונימיזציה של השדה. צריך לציין אילו שדות רוצים להחזיר בתגובה. אין רשימת ברירת מחדל של שדות שמוחזרים. אם לא מציינים את הרשימה הזו, השיטות מחזירות שגיאה. מידע נוסף מופיע במאמר בנושא FieldMask.
- הגרסה החדשה של Place Details (פרטי מקום) תומכת במפתחות API ובאסימוני OAuth כמנגנון אימות.
- רק JSON נתמך כפורמט תגובה בפרטי מקום (חדש).
- פורמט התגובה ב-JSON של Places API (חדש) השתנה מהפורמט של ממשקי ה-API מדור קודם. מידע נוסף מופיע במאמר העברה של תגובת Places API.
בטבלה הבאה מפורטים פרמטרים ב-Place Details (Legacy) ששמם שונה או שהם שונו ב-Place Details (New), או פרמטרים שכבר לא נתמכים.
| הפרמטר הנוכחי | פרמטר חדש | הערות |
|---|---|---|
place_id |
places/PLACE_ID |
המחרוזת places/PLACE_ID נקראת גם שם המשאב של המקום. בתשובה לבקשה של Place Details (New), Nearby Search (New) ו-Text Search (New), המחרוזת הזו מופיעה בשדה name של התשובה.
מזהה המקום העצמאי מופיע בשדה id של התשובה. |
language |
languageCode |
|
region |
regionCode |
דוגמה לבקשה
בדוגמה הבאה מוצגת בקשת GET שמשתמשת בפרטי מקום (גרסה קודמת). בדוגמה הזו, אתם מבקשים תגובת 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), Nearby Search (New) ו-Text Search (New), המחרוזת הזו מופיעה בשדה name של התשובה. מזהה המקום העצמאי מופיע בשדה id של התשובה.