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

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