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

ב-Places API יש תמיכה בפרטי המקומות הקיימים. אם אתם מכירים את Places API הקיים, בגרסה החדשה של Place Details בוצעו השינויים הבאים:

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