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

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

מבוא

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

  • ‫Autocomplete (חדש) משתמש בבקשות 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

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