Die Places API unterstützt die vorhandene Text Search. Wenn Sie mit der bestehenden Text Search vertraut sind, sind die folgenden Änderungen bei der neuen Version der Text Search zu beachten:
- Die neue Text Search verwendet HTTP-POST-Anfragen. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Bei der bisherigen Text Search werden URL-Parameter dagegen über eine HTTP-GET-Anfrage übergeben.
- Die 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 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.Mit der umgekehrten Geocodierung können Sie anhand von Koordinaten nach einer Adresse suchen. Mit der Nearby Search (New) können Sie Orte in der Nähe eines bestimmten Orts finden.
- Das JSON-Antwortformat für die Text Search (New) API unterscheidet sich vom Format der vorhandenen APIs. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
In der folgenden Tabelle sind Parameter der bisherigen Text Search aufgeführt, die für die neue Text Search 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 |
Für alle 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'