Die Places API (alte Version) unterstützt Text Search (alte Version). Wenn Sie mit der bisherigen Version von „Text Search“ vertraut sind, gibt es bei Text Search (New) folgende Änderungen:
- Für die Textsuche (neu) werden HTTP-POST-Anfragen verwendet. Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage übergeben. Bei der alten Text Search-Version 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.
- „Text Search (New)“ 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 Textsuche (alt) können Sie Breiten- und Längengradkoordinaten im Abfragestring angeben. Beispiel:
query=37.4239,-122.0925. Diese Option wird in der Text Search (New)-Funktion 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 API (New) unterscheidet sich vom Format der bisherigen APIs. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
In der folgenden Tabelle sind Parameter in der alten Text Search-Version aufgeführt, die in der neuen Text Search-Version 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 |
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 Text Search (alte Version) 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 Textsuche (neu) 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'