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

‏Places API תומך בממשקי ה-API השלמה אוטומטית של מקומות (קודם) ו-השלמה אוטומטית של שאילתות (קודם). אם אתם מכירים את ממשקי ה-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

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