In diesem Dokument erfahren Sie, wie Sie eine grundlegende Anfrage an die Places Aggregate API senden und die Antwort interpretieren, die eine Anzahl der übereinstimmenden Orte enthält.
Wenn Sie die Places Aggregate API verwenden möchten, senden Sie eine HTTP POST-Anfrage an den computeInsights-Endpunkt:
https://areainsights.googleapis.com/v1:computeInsights
Sie können Ihre Anfrage verfeinern, indem Sie im JSON-Text Region- und Typparameter angeben. In diesem Beispiel wird eine Anfrage gezeigt, mit der die Anzahl der Restaurants in San Francisco zurückgegeben wird, die geöffnet sind, mäßig preislich und zwischen 4 und 5 Sternen bewertet sind.
curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"insights":[
"INSIGHT_COUNT"
],
"filter":{
"locationFilter":{
"region":{
"place":"places/ChIJIQBpAG2ahYAR_6128GcTUEo"
}
},
"typeFilter":{
"includedTypes":[
"restaurant"
]
},
"operatingStatus":[
"OPERATING_STATUS_OPERATIONAL"
],
"priceLevels":[
"PRICE_LEVEL_INEXPENSIVE"
],
"ratingFilter":{
"minRating":4.0,
"maxRating":5.0
}
}
}'
Places Aggregate API-Antwort
Die folgende Antwort auf die Beispielanfrage oben zeigt die Anzahl der Restaurants, die den Kriterien entsprechen.
{ "count": "850" }
Testen!
Mit dem API Explorer können Sie Beispielanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen.
- Wählen Sie rechts auf der Seite das API-Symbol
aus. - Maximieren Sie optional Standardparameter anzeigen, um Parameter festzulegen.
- Optional können Sie den Anfragetext bearbeiten.
- Klicken Sie auf die Schaltfläche Ausführen. Wählen Sie im Dialogfeld das Konto aus, mit dem Sie die Anfrage stellen möchten.
Klicken Sie im API Explorer-Steuerfeld auf das Symbol zum Maximieren
, um das Fenster des API Explorer zu maximieren.
Nächste Schritte
- Weitere Beispiele für die Verwendung der Places Aggregate API
- Sehen Sie sich die Anfrageparameter genauer an.
- Vollständige API-Dokumentation ansehen