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 שמכילה מידע על מזהה מקום ומעבירים את כל הפרמטרים כפרמטרים של כתובת אתר. בדוגמה הזו משתמשים גם ב-fields
כך שהתשובה כוללת רק את השם המוצג ואת הכתובת בפורמט של המקום:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
באפשרות Place Details (New), שולחים בקשת 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
של התשובה.