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

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

מבוא

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

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

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

ב-Text Search (חדש), שולחים בקשת 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'