ב-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
כשמשתמשים ב-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'