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

מפתחים באזור הכלכלי האירופי (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