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

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

מבוא

‫Places API תומך בממשקי ה-API השלמה אוטומטית למקומות (דור קודם) והשלמה אוטומטית של שאילתות (דור קודם). אם אתם מכירים את ממשקי ה-API האלה, ב-Autocomplete (New)‎ יש את השינויים הבאים:

  • השלמה אוטומטית (חדש) משתמשת בבקשות HTTP POST. מעבירים פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST. לעומת זאת, בממשקי ה-API הקודמים, מעבירים פרמטרים של כתובות URL באמצעות בקשת HTTP GET.
  • ההשלמה האוטומטית (חדש) תומכת גם במפתחות 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

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