העברה לחיפוש טקסט (חדש)

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

מבוא

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

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

  • בחיפוש טקסט (הגרסה הקודמת) אפשר לציין קואורדינטות של קו רוחב וקו אורך במחרוזת השאילתה. לדוגמה: query=37.4239,-122.0925. האפשרות הזו לא נתמכת בחיפוש טקסט (חדש).

    אפשר להשתמש בהמרת קואורדינטות לכתובות (reverse geocoding) כדי לחפש קואורדינטות ולקבל כתובת, או בחיפוש בסביבה (חדש) כדי למצוא מקומות בסביבה של מיקום מסוים.

  • פורמט התגובה ב-JSON של חיפוש טקסט (חדש) השתנה בהשוואה לפורמט של ממשקי ה-API הקודמים. פרטים נוספים זמינים במאמר העברת התגובה של Places API.

בטבלה הבאה מפורטים פרמטרים בחיפוש טקסט (הגרסה הקודמת) ששמם השתנה או שהם שונו בחיפוש טקסט (הגרסה החדשה), או פרמטרים שכבר לא נתמכים.

הפרמטר הנוכחי פרמטר חדש הערות
evOptions פרמטר חדש.
language languageCode
location locationBias
maxprice/minprice priceLevels
opennow openNow
pagetoken pageToken
query textQuery חובה בכל הבקשות.
radius locationBias מציינים את הרדיוס כשמגדירים locationBias.
region regionCode
type includedType אפשר להזין רק ערך אחד.
strictTypeFiltering פרמטר חדש.

דוגמה לבקשה

בדוגמה הבאה של בקשת GET נעשה שימוש בחיפוש טקסט (מדור קודם). בדוגמה הזו, אתם מבקשים תגובת JSON שמכילה מידע על "אוכל צמחוני חריף בסידני, אוסטרליה" ומעבירים את כל הפרמטרים כפרמטרים של כתובת URL:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY

בחיפוש טקסט (חדש), שולחים בקשת POST ומעבירים את כל הפרמטרים בגוף הבקשה בפורמט JSON או בכותרות כחלק מבקשת ה-POST. בדוגמה הזו נעשה שימוש גם במסכת שדה, כך שהתגובה כוללת רק את השם המוצג ואת הכתובת בפורמט של המקום:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-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:searchText'