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