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

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

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

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