העברה להשלמה אוטומטית (חדש)

מבוא

‫Places API תומך בממשקי ה-API‏ השלמה אוטומטית למקומות (מדור ישן) ו-Query Autocomplete (מדור ישן). אם אתם מכירים את ממשקי ה-API האלה, התכונה 'השלמה אוטומטית (חדשה)' מבצעת את השינויים הבאים:

• ההשלמה האוטומטית (חדש) משתמשת בבקשות HTTP POST. מעבירים פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST. לעומת זאת, בממשקי API מדור קודם, מעבירים פרמטרים של כתובת URL באמצעות בקשת GET.
• הווידג'ט Autocomplete (חדש) תומך במפתחות API ובאסימוני OAuth כמנגנון אימות.
• במאפיין 'השלמה אוטומטית (חדש)' יש תמיכה רק בפורמט JSON כתגובה.

בטבלה הבאה מפורטים פרמטרים ב-השלמה אוטומטית למקומות (מדור קודם) וב-Query Autocomplete (מדור קודם) ששמם שונה או שהם שונו ב-Autocomplete (חדש), או פרמטרים שכבר לא נתמכים.

הפרמטר הנוכחי	פרמטר חדש	הערות
components	includedRegionCodes
language	languageCode
location	locationBias
ipbias		אם לא מציינים את locationBias וגם לא את locationRestriction, ממשק ה-API משתמש בהטיית כתובות IP כברירת מחדל.
offset	inputOffset
radius	locationBias או locationRestriction
region	regionCode
stricbounds	locationRestriction
sessiontoken	sessionToken
types	includedPrimaryTypes

דוגמה לבקשה

בדוגמה הבאה מוצגת בקשת GET שמשתמשת בהשלמה אוטומטית למקומות (מדור קודם). בדוגמה הזו, אתם מבקשים תגובת JSON שמכילה מידע על מקומות בשם Amoeba מסוג establishment, ומעבירים את כל הפרמטרים כפרמטרים של כתובת URL:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

בשימוש בתכונה 'השלמה אוטומטית (חדשה)', שולחים בקשת POST ומעבירים את כל הפרמטרים בגוף בקשת ה-JSON או בכותרות כחלק מבקשת ה-POST.

לא צריך להשתמש במסכות שדות בבקשות של השלמה אוטומטית (חדשה), אבל אפשר להשתמש בהן כדי לסנן תוצאות ספציפיות בתגובה. לדוגמה, בבקשה הבאה נעשה שימוש במסכת שדות, כך שהתשובה כוללת רק את suggestions.placePrediction.text של ההצעה:

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

מידע נוסף על השימוש במסכות שדות מופיע במאמר בנושא פרטי מקומות (חדש).