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

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

מבוא

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

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