מבוא
Places API (מדור קודם) תומך ב-חיפוש טקסט (מדור קודם). אם אתם מכירים את חיפוש טקסט (חדש), אתם יכולים לראות את השינויים הבאים:
- חיפוש טקסט (חדש) משתמש בבקשות HTTP POST. העברת פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST. לעומת זאת, בחיפוש טקסט (מדור קודם), מעבירים פרמטרים של כתובת URL באמצעות בקשת 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 שמכילה מידע על "אוכל צמחוני חריף בסידני, אוסטרליה" ומעבירים את כל הפרמטרים כפרמטרים של כתובת 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'