העברה לפרטי מקום (חדש)

ב-Places API יש תמיכה ב-פרטי מקומות (קודם). אם אתם מכירים את Places API (מדור קודם), פרטי המיקום (דור חדש) כולל את השינויים הבאים:

• חובה לבצע אנונימיזציה של השדות. צריך לציין את השדות שרוצים להחזיר בתגובה. אין רשימת ברירת מחדל של שדות שמוחזרים. אם משמיטים את הרשימה הזו, השיטות מחזירות שגיאה. מידע נוסף זמין במאמר FieldMask.
• האפשרות החדשה של פרטי המקום תומכת גם במפתחות API וגם באסימוני OAuth כמנגנון אימות.
• רק פורמט JSON נתמך בתגובה של פרטי המקום החדשים.
• פורמט התשובה ב-JSON של ה-API של פרטי המקומות (חדש) השתנה מהפורמט של ממשקי ה-API הקודמים. מידע נוסף זמין במאמר העברת התגובה של Places API.

בטבלה הבאה מפורטים פרמטרים ב'פרטי המקום (מדור קודם)' ששינו את השם או שונו ל'פרטי המקום (חדש)', או פרמטרים שלא נתמכים יותר.

בקשה לדוגמה

בבקשת ה-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 בתגובה.