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

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

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

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

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

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

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

דוגמה לבקשה

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

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'