Places API unterstützt die bestehende Textsuche: Wenn Sie mit den bestehenden „Text Search“, die neue Version von Text Search nimmt folgende Änderungen vor:
- Die neue Text Search verwendet HTTP POST-Anfragen. Bestanden -Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Im Gegensatz dazu übergeben Sie bei der bestehenden Textsuche URL-Parameter mit einer HTTP-GET-Anfrage.
- Die Maskierung von Feldern ist erforderlich. Sie müssen angeben, welche Felder zurückgegeben werden sollen in der Antwort angeben. Es gibt keine Standardliste der zurückgegebenen Felder. Wenn Sie diese Liste enthält, geben die Methoden einen Fehler zurück. Weitere Informationen finden Sie unter FieldMask.
- Die neue Text Search unterstützt beide API-Schlüssel und OAuth-Tokens als Authentifizierungsmechanismus.
- In der neuen Version wird nur JSON als Antwortformat unterstützt. Textsuche.
Mit der vorhandenen Text Search-Funktion können Sie Breiten- und Längengrade angeben -Koordinaten in der Abfragezeichenfolge. Beispiel:
query=37.4239,-122.0925. Diese Option wird in der neuen Textsuche nicht unterstützt.Verwenden Sie Umgekehrte Geocodierung , um nach Koordinaten zu suchen und eine Adresse zurückzugeben, oder Nearby Search (neu) um Orte in der Nähe eines bestimmten Standorts zu finden.
- Das JSON-Antwortformat für „Text Search (New)“ Das Format der vorhandenen APIs hat sich geändert. Weitere Informationen finden Sie unter Migrieren Sie die Places API-Antwort.
In der folgenden Tabelle sind die Parameter der vorhandenen „Text Search“, die für die neuen Text Search oder Parameter, die nicht mehr unterstützt.
| Aktueller Parameter | Neuer Parameter | Hinweise |
|---|---|---|
evOptions |
Neuer Parameter. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
Nicht unterstützt. | |
query |
textQuery |
In allen Anfragen erforderlich. |
radius |
locationBias |
Geben Sie den Umkreis an, wenn Sie eine locationBias definieren. |
region |
regionCode |
|
type |
includedType |
Nimmt nur einen Wert an. |
strictTypeFiltering |
Neuer Parameter. |
Beispielanfrage
Im folgenden Beispiel für eine GET-Anfrage wird die vorhandene Textsuche. In diesem Beispiel fordern Sie eine JSON-Datei an, Antwort mit Informationen zu „Scharfes vegetarisches Essen in Sydney, Australien“ und alle Parameter als URL-Parameter übergeben:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
Mit „Text Search (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 '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'