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

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

• התכונה החדשה 'חיפוש בקרבת מקום' משתמשת בבקשות 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 משתמשת חיפוש בקרבת מקום. בדוגמה הזאת, מבקשים קובץ 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