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

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

מבוא

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

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

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

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

  • פורמט התשובה ב-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 שמכילה מידע על 'Spicy Vegetarian Food in Sydney, Australia' ומעבירים את כל הפרמטרים כפרמטרים של כתובת 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'