In diesem Dokument wird beschrieben, wie Sie eine einfache Anfrage an die Places Aggregate API senden und die Antwort interpretieren, die eine Anzahl übereinstimmender Orte enthält.
Wenn Sie die Places Aggregate API verwenden möchten, senden Sie eine HTTP-POST-Anfrage an den Endpunkt computeInsights:
https://areainsights.googleapis.com/v1:computeInsights
Sie können Ihre Anfrage verfeinern, indem Sie im JSON Text die Parameter „region“ und „type“ angeben. In diesem Beispiel wird die Anzahl der Restaurants in San Francisco zurückgegeben, die geöffnet sind, ein moderates Preisniveau haben und mit 4 bis 5 Sternen bewertet wurden.
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
}
}
}'
Antwort der Places Aggregate API
Die folgende Antwort auf die Beispielanfrage oben zeigt die Anzahl der Restaurants, die die Kriterien erfüllen.
{ "count": "850" }
Testen!
Mit dem API Explorer können Sie Beispielanfragen senden, um sich mit der API und den API-Optionen vertraut zu machen.
- Wählen Sie auf der rechten Seite der Seite das API-Symbol aus:
,
- Optional können Sie Standardparameter anzeigen maximieren, um Parameter festzulegen.
- Optional können Sie den Anfragetext bearbeiten.
- Wählen Sie die Schaltfläche Ausführen aus. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.
Wählen Sie im API Explorer-Feld das Maximierungssymbol aus:
, um das API Explorer-Fenster zu maximieren.
Nächste Schritte
- Weitere Beispiele für die Möglichkeiten der Places Aggregate API
- Anfrageparameter im Detail ansehen
- Vollständige API-Dokumentation ansehen.