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