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

‏Places API תומך בחיפוש בקרבת מקום (קודם). אם אתם מכירים את 'חיפוש בקרבת מקום' (ממשק הקודם), חיפוש בקרבת מקום (ממשק חדש) כולל את השינויים הבאים:

  • בחיפוש החדש בסביבה נעשה שימוש בבקשות HTTP POST. העברת פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST. לעומת זאת, בחיפוש בקרבת מקום (מדור קודם), מעבירים פרמטרים של כתובות URL באמצעות בקשת HTTP GET.
  • חובה לבצע אנונימיזציה של השדות. צריך לציין את השדות שרוצים להחזיר בתגובה. אין רשימת ברירת מחדל של שדות שמוחזרים. אם משמיטים את הרשימה הזו, השיטות מחזירות שגיאה. מידע נוסף זמין במאמר FieldMask.
  • בחיפוש בקרבת מקום (חדש) יש תמיכה גם במפתחות API וגם באסימוני OAuth כמנגנון אימות.
  • רק פורמט JSON נתמך בתגובה בחיפוש בקרבת מקום (חדש).
  • מעכשיו, כל הבקשות שכוללות שאילתה בטקסט צריכות להשתמש בחיפוש טקסט (חדש), כי חיפוש בקרבת מקום (חדש) לא תומך בהזנת טקסט.
  • פורמט התשובה ב-JSON לחיפוש בקרבת מקום (חדש) השתנה מהפורמט של ממשקי ה-API הקודמים. מידע נוסף זמין במאמר העברת התגובה של Places API.

בטבלה הבאה מפורטים פרמטרים בחיפוש בקרבת מקום (ממשק הקודם) ששינו את השם או שונו בחיפוש בקרבת מקום (ממשק חדש), או פרמטרים שלא נתמכים יותר.

הפרמטר הנוכחי פרמטר חדש הערות
keyword לא נתמכת. במקום זאת, צריך להשתמש באפשרות חיפוש טקסט (חדש).
language languageCode
location locationRestriction חובה.
maxprice/minprice לא נתמכת.
maxResultCount פרמטר חדש.
opennow לא נתמכת.
pagetoken לא נתמכת.
radius אפשר להשתמש ב-locationRestriction עכשיו.
rankby rankPreference
regionCode פרמטר חדש.
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
הפרמטרים החדשים מקבלים גם כמה ערכים של סוגים. ב-API הקודם אפשר להזין רק ערך אחד.

בקשה לדוגמה

בבקשת ה-GET לדוגמה הבאה נעשה שימוש בחיפוש בקרבת מקום (מדור קודם). בדוגמה הזו, מבקשים תגובה בפורמט JSON שמכילה מידע על מקומות מסוג restaurant ומעבירים את כל הפרמטרים כפרמטרים של כתובת URL:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'

כשמשתמשים בחיפוש בקרבת מקום (חדש), שולחים בקשת POST ומעבירים את כל הפרמטרים בגוף הבקשה בפורמט JSON או בכותרות כחלק מבקשת ה-POST. בדוגמה הזו נעשה שימוש גם במסכת שדה, כך שהתגובה כוללת רק את השם המוצג ואת הכתובת בפורמט של המקום:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby