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