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