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

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 משתמשת השלמה אוטומטית למקומות. בדוגמה הזו, מבקשים תגובה מסוג 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

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