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

Places API תומך בחיפוש בקרבת מקום הקיים. אם אתם מכירים את הגרסה הקיימת של Nearby Search, הגרסה החדשה של Nearby Search כוללת את השינויים הבאים:

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

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