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

מבוא

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

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