Einführung
Die Places API (Legacy) unterstützt Text Search (Legacy). Wenn Sie mit Text Search (Legacy) vertraut sind, beachten Sie die folgenden Änderungen bei Text Search (New):
- Für Text Search (New) werden HTTP-POST-Anfragen verwendet. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Bei der Textsuche (Legacy) übergeben Sie URL-Parameter dagegen mit einer HTTP-GET-Anfrage.
- 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 (neu) unterstützt sowohl API-Schlüssel als auch OAuth-Tokens als Authentifizierungsmechanismus.
- Bei der Textsuche (Neu) wird nur JSON als Antwortformat unterstützt.
Bei der Textsuche (Legacy) können Sie Breiten- und Längengrade im Abfragestring angeben. Beispiel:
query=37.4239,-122.0925. Diese Option wird in Text Search (New) nicht unterstützt.Verwenden Sie die umgekehrte Geocodierung, um nach Koordinaten zu suchen und eine Adresse zurückzugeben, oder Nearby Search (New), um Orte in der Nähe eines bestimmten Standorts zu finden.
- Das JSON-Antwortformat für Text Search (New) hat sich im Vergleich zu den Legacy-APIs geändert. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
In der folgenden Tabelle sind Parameter in Text Search (Legacy) aufgeführt, die für Text Search (New) 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 |
In allen Anfragen erforderlich. |
radius |
locationBias |
Geben Sie den Radius an, wenn Sie einen locationBias definieren. |
region |
regionCode |
|
type |
includedType |
Es wird nur ein einziger Wert unterstützt. |
strictTypeFiltering |
Neuer Parameter. |
Beispielanfrage
In der folgenden GET-Beispielanfrage wird die Textsuche (Legacy) 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 „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'