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

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

מבוא

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

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

העברה לחיפוש בקרבת מקום (חדש) קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

מבוא

דוגמה לבקשה

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