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