Z tego dokumentu dowiesz się, jak wysłać podstawowe żądanie do interfejsu Places Aggregate API i jak interpretować odpowiedź, która zawiera liczbę pasujących miejsc.
Aby użyć interfejsu Places Aggregate API, wyślij żądanie HTTP POST do punktu końcowego computeInsights
w ten sposób:
https://areainsights.googleapis.com/v1:computeInsights
Uściślij żądanie, podając parametry regionu i typu w treści JSON. Ten przykład pokazuje żądanie zwrócenia liczby restauracji w San Francisco, które są otwarte, mają umiarkowane ceny i ocenę od 4 do 5 gwiazdek.
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 } } }'
Odpowiedź interfejsu Places Aggregate API
Odpowiedź na przykładowe żądanie powyżej zawiera liczbę restauracji spełniających kryteria.
{ "count": "850" }
Wypróbuj
Narzędzie API Explorer umożliwia wysyłanie przykładowych żądań, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami.
- Po prawej stronie strony kliknij ikonę interfejsu API
.
- Opcjonalnie rozwiń Pokaż standardowe parametry, aby ustawić dowolne parametry.
- Opcjonalnie edytuj treść żądania.
- Kliknij przycisk Wykonaj. W oknie dialogowym wybierz konto, z którego chcesz wysłać prośbę.
W panelu API Explorer kliknij ikonę rozwijania
, aby rozwinąć okno API Explorer.
Co dalej?
- Zobacz więcej przykładów tego, co możesz osiągnąć dzięki interfejsowi Places Aggregate API.
- Przyjrzyj się bliżej parametrom żądania.
- Zapoznaj się z pełną dokumentacją interfejsu API.