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