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

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