Die Places API unterstützt die vorhandene Textsuche. Wenn Sie mit der bestehenden Textsuche vertraut sind, werden in der neuen Version von Text Search folgende Änderungen vorgenommen:
- Die neue Text Search verwendet HTTP POST-Anfragen. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Im Gegensatz dazu werden URL-Parameter bei der vorhandenen Text Search-Anfrage mithilfe einer HTTP-GET-Anfrage übergeben.
- Die Maskierung von Feldern ist erforderlich. Sie müssen angeben, welche Felder in der Antwort zurückgegeben werden sollen. Es gibt keine Standardliste der zurückgegebenen Felder. Wenn Sie diese Liste weglassen, geben die Methoden einen Fehler zurück. Weitere Informationen finden Sie unter FieldMask.
- Die neue Text Search unterstützt sowohl API-Schlüssel als auch OAuth-Tokens als Authentifizierungsmechanismus.
- In der neuen Text Search wird nur JSON als Antwortformat unterstützt.
Mit der vorhandenen Text Search-Funktion können Sie Breiten- und Längengrade im Abfragestring angeben. Beispiel:
query=37.4239,-122.0925. Diese Option wird in der neuen Textsuche nicht unterstützt.Verwenden Sie die umgekehrte Geocodierung, um anhand von Koordinaten 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 die Text Search (New) API hat sich im Vergleich zum Format der vorhandenen APIs geändert. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
In der folgenden Tabelle sind Parameter der vorhandenen Text Search aufgeführt, die für die neue Text Search umbenannt oder geändert wurden, sowie Parameter, die nicht mehr unterstützt werden.
| 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 Text Search verwendet. In diesem Beispiel fordern Sie eine JSON-Antwort mit Informationen zu „Spicy Vegetarian Food in Sydney, Australia“ an und übergeben alle Parameter als URL-Parameter:
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 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 den Anzeigenamen und die formatierte Adresse des Orts enthält:
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'