העברה לחיפוש טקסט (חדש)

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

כשמשתמשים בחיפוש טקסט (חדש), שולחים בקשת 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'