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

מפתחים באזור הכלכלי האירופי (EEA)

מבוא

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

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

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

הפרמטר הנוכחי פרמטר חדש הערות
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

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