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

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

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

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

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

לא צריך להשתמש במסכות שדות לבקשות של השלמה אוטומטית (חדש), אבל אפשר להשתמש בהן כדי לסנן תוצאות ספציפיות בתגובה. לדוגמה, בבקשה הבאה נעשה שימוש במסכת שדה, כך שהתגובה כוללת רק את הערך 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

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