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