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

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

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