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