Die Places API unterstützt die vorhandene Text Search. Wenn Sie mit der bisherigen Textsuche vertraut sind, sind die folgenden Änderungen in der neuen Version der Textsuche zu beachten:
- Die neue Text Search verwendet HTTP-POST-Anfragen. Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage übergeben. Bei der bestehenden Text Search werden URL-Parameter dagegen über eine HTTP-GET-Anfrage übergeben.
- Feldmaskierung 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.
Bei der vorhandenen Textsuche können Sie Breiten- und Längengradkoordinaten im Abfragestring angeben. Beispiel:
query=37.4239,-122.0925. Diese Option wird in der neuen Text Search nicht unterstützt.Verwenden Sie die umgekehrte Geocodierung, um anhand von Koordinaten nach einer Adresse zu suchen, oder die Suche in der Nähe (neu), um Orte in der Nähe eines bestimmten Orts zu finden.
- Das JSON-Antwortformat der Text Search API (New) unterscheidet sich vom Format der vorhandenen APIs. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
In der folgenden Tabelle sind Parameter der bestehenden Textsuche aufgeführt, die für die neue Textsuche umbenannt oder geändert wurden, oder 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 |
pageToken |
|
query |
textQuery |
In allen Anfragen erforderlich. |
radius |
locationBias |
Geben Sie den Radius an, wenn Sie eine locationBias definieren. |
region |
regionCode |
|
type |
includedType |
Es kann nur einen einzelnen Wert annehmen. |
strictTypeFiltering |
Neuer Parameter. |
Beispielanfrage
In der folgenden Beispiel-GET-Anfrage wird die vorhandene Textsuche 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
Bei der Text Search (Neu) senden 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'