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

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

• בחיפוש החדש בסביבה נעשה שימוש בבקשות HTTP POST. מעבירים פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST. לעומת זאת, בחיפוש הקרוב הקיים, מעבירים את הפרמטרים של כתובת ה-URL באמצעות בקשת 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 לדוגמה הבאה נעשה שימוש בחיפוש הקרוב הקיים. בדוגמה הזו מבקשים תגובה בפורמט 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 או בכותרות כחלק מהבקשה. בדוגמה הזו נעשה שימוש גם במסכת שדה, כך שהתגובה כוללת רק את השם המוצג ואת הכתובת בפורמט של המקום:

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