Places API תומך ב-Text Search הקיים. אם אתם מכירים את חיפוש הטקסט הקיים, הגרסה החדשה של חיפוש טקסט מבצעת את השינויים הבאים:
- הממשק החדש של חיפוש טקסט משתמש בבקשות HTTP POST. צריך להעביר פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST. לעומת זאת, ב-Text Search הקיים, מעבירים פרמטרים של כתובות אתרים באמצעות בקשת HTTP GET.
- צריך לבצע אנונימיזציה של השדות. צריך לציין אילו שדות רוצים להחזיר בתשובה. אין רשימת ברירת מחדל של השדות שהוחזרו. אם משמיטים את הרשימה הזו, השיטות יחזירו שגיאה. מידע נוסף זמין במאמר FieldMask.
- הגרסה החדשה של חיפוש טקסט תומכת גם באסימוני מפתחות API וגם באסימונים של OAuth כמנגנון האימות.
- בחיפוש הטקסט החדש יש תמיכה רק ב-JSON כפורמט תגובה.
בחיפוש הטקסט הקיים אפשר לציין קואורדינטות של קו רוחב וקו אורך במחרוזת השאילתה. לדוגמה:
query=37.4239,-122.0925. האפשרות הזו לא נתמכת בחיפוש הטקסט החדש.אפשר להשתמש ב-Reverse Geocoding כדי לחפש קואורדינטות ולהחזיר כתובת, או להשתמש ב-Nearby Search (חדש) כדי למצוא מקומות מסביב למיקום מסוים.
- הפורמט של התגובה בפורמט JSON ל-Text Search (New) 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 משתמשת ב-Text Search הקיים. בדוגמה הזו, מבקשים תשובת 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'