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