Places API unterstützt die bestehende Automatische Vervollständigung und Query Autocomplete APIs. Wenn Sie mit diesen APIs vertraut sind, nimmt Autocomplete (New) die folgenden Änderungen vor:
- Autocomplete (New) verwendet HTTP POST-Anfragen. Parameter übergeben in im Anfragetext oder in Headern als Teil einer HTTP POST-Anfrage. Im Gegensatz dazu mit den vorhandenen APIs verwenden, übergeben Sie URL-Parameter mithilfe eines HTTP GET-Anfrage
- Die automatische Vervollständigung (New) unterstützt beide API-Schlüssel. und OAuth-Tokens als Authentifizierungsmechanismus.
- In „Autocomplete (New)“ wird nur JSON als Antwortformat unterstützt.
In der folgenden Tabelle sind die Parameter der vorhandenen Autocomplete und Query Autocomplete APIs, die für „Autocomplete (New)“ oder nicht mehr unterstützte Parameter umbenannt oder geändert wurden.
Aktueller Parameter | Neuer Parameter | Hinweise |
---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Wenn Sie sowohl locationBias als auch locationRestriction weglassen,
Die API verwendet standardmäßig die IP-Gewichtung. |
|
offset |
inputOffset |
|
radius |
locationBias oder locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Beispielanfrage
Im folgenden Beispiel für eine GET-Anfrage wird die vorhandene
Place Autocomplete In diesem Beispiel fordern Sie eine JSON-Datei an,
Antwort mit Informationen zu Orten mit dem Namen „Amoeba“ vom Typ
establishment
und übergeben Sie alle Parameter als URL-Parameter:
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'
Mit Autocomplete (New) stellen Sie eine POST-Anfrage und Übergeben Sie alle Parameter im JSON-Anfragetext oder in Headern als Teil der POST-Anfrage In diesem Beispiel wird auch eine Feldmaske verwendet, sodass die Antwort nur das Feld Anzeigename und formatierte Adresse des Orts:
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