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

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

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

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" \
https://places.googleapis.com/v1/places:autocomplete