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