Die Places API unterstützt die vorhandene Text Search. Wenn Sie mit der vorhandenen „Text Search“ vertraut sind, werden in der neuen Version von „Text Search“ die folgenden Änderungen vorgenommen:
- Die neue Textsuche verwendet HTTP-POST-Anfragen. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Im Gegensatz dazu übergeben Sie bei der vorhandenen „Text Search“-Funktion URL-Parameter mit einer HTTP-GET-Anfrage.
- 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 auslassen, geben die Methoden einen Fehler zurück. Weitere Informationen findest du unter FieldMask.
- Die neue Textsuche unterstützt sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.
- In der neuen Text Search-Version wird nur JSON als Antwortformat unterstützt.
Bei 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 nach Koordinaten zu suchen und eine Adresse zurückzugeben. Mit Nearby Search (neu) finden Sie Orte in der Nähe eines bestimmten Standorts.
- Das JSON-Antwortformat für die Text Search (New) API hat sich gegenüber dem Format der vorhandenen APIs geändert. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
In der folgenden Tabelle sind Parameter in der vorhandenen Text Search aufgeführt, die für die neue Text Search-Version 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 |
Nicht unterstützt. | |
query |
textQuery |
In allen Anfragen erforderlich. |
radius |
locationBias |
Geben Sie den Umkreis an, wenn Sie einen locationBias definieren. |
region |
regionCode |
|
type |
includedType |
Nimmt nur einen einzelnen Wert an. |
strictTypeFiltering |
Neuer Parameter. |
Beispielanfrage
In der folgenden GET-Beispielanfrage wird die vorhandene Text Search-Anfrage verwendet. In diesem Beispiel fordern Sie eine JSON-Antwort mit Informationen zu „Spicy Vegetarian Food in Sydney, Australia“ (Spicy Vegetarian Food in Sydney, Australien) 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 dabei 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'