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

מפתחים באזור הכלכלי האירופי (EEA)

מבוא

‫Places API תומך ב-חיפוש בסביבה (מדור קודם). אם אתם מכירים את הגרסה הקודמת של 'חיפוש בסביבה', ב גרסה החדשה של 'חיפוש בסביבה' בוצעו השינויים הבאים:

  • הגרסה החדשה של חיפוש בסביבה הקרובה משתמשת בבקשות HTTP POST. מעבירים פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST. לעומת זאת, בחיפוש בסביבה (מדור קודם), מעבירים פרמטרים של כתובת URL באמצעות בקשת 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