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

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

מבוא

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

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