platypush/platypush
platypush/platypush
2
2
Fork 4
Code Issues30 Pull requests Projects4 Releases Packages Wiki Activity

[foursquare] Adapted to latest API version.

Browse source
This commit is contained in:
Fabio Manganiello 2025-03-11 21:41:43 +01:00
parent 0de6c1004c
commit 4368ef79d2
Signed by: blacklight
GPG key ID: D90FBA7F76362774
1 changed files with 43 additions and 211 deletions

254
platypush/plugins/foursquare/__init__.py
View file

@ -1,5 +1,5 @@
import datetime
from typing import List, Dict, Any, Optional, Union, Tuple
from typing import List, Dict, Any, Optional
import requests
@ -31,6 +31,8 @@ class FoursquarePlugin(RunnablePlugin):
api_base_url = 'https://api.foursquare.com/v2'
_last_created_at_varname = '_foursquare_checkin_last_created_at'
_http_timeout = 10
# API version to use, see https://docs.foursquare.com/developer/reference/versioning
_api_version = '20240101'
def __init__(self, access_token: str, poll_interval: float = 120, **kwargs):
"""
@ -41,20 +43,16 @@ class FoursquarePlugin(RunnablePlugin):
self._last_created_at = Variable(self._last_created_at_varname)
def _get_url(self, endpoint):
return (
self.api_base_url
+ '/'
+ endpoint
+ '?oauth_token='
+ self.access_token
+ '&v='
+ datetime.date.today().strftime('%Y%m%d')
)
return f'{self.api_base_url}/{endpoint}?oauth_token={self.access_token}&v={self._api_version}'
def _get_checkins(self) -> List[Dict[str, Any]]:
def _get_checkins(self, limit: int, offset: int) -> List[Dict[str, Any]]:
url = self._get_url('users/self/checkins')
return (
requests.get(url, timeout=self._http_timeout)
requests.get(
url,
json={'limit': limit, 'offset': offset},
timeout=self._http_timeout,
)
.json()
.get('response', {})
.get('checkins', {})
@ -62,48 +60,42 @@ class FoursquarePlugin(RunnablePlugin):
)
@action
def get_checkins(self) -> List[Dict[str, Any]]:
def get_checkins(self, limit: int = 20, offset: int = 0) -> List[Dict[str, Any]]:
"""
Get the list of check-ins of the current user.
:return: A list of checkins, as returned by the Foursquare API.
"""
return self._get_checkins()
return self._get_checkins(limit=limit, offset=offset)
@action
def search(
self,
latitude: Optional[float] = None,
longitude: Optional[float] = None,
altitude: Optional[float] = None,
latlng_accuracy: Optional[float] = None,
altitude_accuracy: Optional[float] = None,
near: Optional[str] = None,
query: Optional[str] = None,
limit: Optional[int] = None,
url: Optional[str] = None,
categories: Optional[List[str]] = None,
radius: Optional[int] = None,
sw: Optional[Union[Tuple[float], List[float]]] = None,
ne: Optional[Union[Tuple[float], List[float]]] = None,
) -> List[Dict[str, Any]]:
"""
Search for venues.
:param latitude: Search near this latitude. Note either ``latitude, longitude`` or ``near`` should be provided.
:param longitude: Search near this latitude. Note either ``latitude, longitude`` or ``near`` should be provided.
:param near: Search near this place (e.g. "Chicago, IL" or "Amsterdam, NL"). Note either
``latitude, longitude`` or ``near`` should be provided.
:param altitude: Search near this altitude in meters.
:param latlng_accuracy: Latitude/longitude accuracy in meters.
:param altitude_accuracy: Altitude accuracy in meters.
:param latitude: Search near this latitude. Note either ``latitude,
longitude`` or ``near`` should be provided.
:param longitude: Search near this latitude. Note either ``latitude,
longitude`` or ``near`` should be provided.
:param near: Search near this place (e.g. "Chicago, IL" or "Amsterdam,
NL"). Note either ``latitude, longitude`` or ``near`` should be
provided.
:param query: Search query (e.g. "coffee shops" or "restaurants").
:param limit: Maximum number of results.
:param url: Venue URL to search.
:param categories: List of `category IDs <https://developer.foursquare.com/docs/resources/categories>`_
to be searched.
:param url: A 3rd-party URL associated to the venue to be searched.
:param categories: List of `category IDs
<https://developer.foursquare.com/docs/resources/categories>`_ to be
searched.
:param radius: Search radius in meters.
:param sw: South/west boundary box as a ``[latitude, longitude]`` pair.
:param ne: North/east boundary box as a ``[latitude, longitude]`` pair.
:return: A list of venues, as returned by the Foursquare API.
"""
assert (
@ -115,12 +107,6 @@ class FoursquarePlugin(RunnablePlugin):
args['ll'] = ','.join([str(latitude), str(longitude)])
if near:
args['near'] = near
if altitude:
args['alt'] = altitude
if latlng_accuracy:
args['llAcc'] = latlng_accuracy
if altitude_accuracy:
args['altAcc'] = altitude_accuracy
if query:
args['query'] = query
if limit:
@ -131,10 +117,6 @@ class FoursquarePlugin(RunnablePlugin):
args['categoryId'] = ','.join(categories)
if radius:
args['radius'] = radius
if sw:
args['sw'] = sw
if ne:
args['ne'] = ne
return (
requests.get(
@ -150,54 +132,28 @@ class FoursquarePlugin(RunnablePlugin):
self,
latitude: Optional[float] = None,
longitude: Optional[float] = None,
altitude: Optional[float] = None,
latlng_accuracy: Optional[float] = None,
altitude_accuracy: Optional[float] = None,
section: Optional[str] = None,
near: Optional[str] = None,
query: Optional[str] = None,
limit: Optional[int] = None,
categories: Optional[List[str]] = None,
radius: Optional[int] = None,
open_now: bool = True,
sort_by_distance: Optional[bool] = None,
sort_by_popularity: Optional[bool] = None,
price: Optional[List[int]] = None,
saved: Optional[bool] = None,
) -> List[Dict[str, Any]]:
"""
Explore venues around a location.
:param latitude: Search near this latitude. Note either ``latitude, longitude`` or ``near`` should be provided.
:param longitude: Search near this latitude. Note either ``latitude, longitude`` or ``near`` should be provided.
:param near: Search near this place (e.g. "Chicago, IL" or "Amsterdam, NL"). Note either
``latitude, longitude`` or ``near`` should be provided.
:param altitude: Search near this altitude in meters.
:param latlng_accuracy: Latitude/longitude accuracy in meters.
:param altitude_accuracy: Altitude accuracy in meters.
:param section: Section to search. Supported values:
- food
- drinks
- coffee
- shops
- arts
- outdoors
- sights
- trending
- nextVenues
:param query: Search query (e.g. "coffee shops" or "restaurants"). The parameter has no effect if
``section`` is specified.
:param latitude: Search near this latitude. Note either ``latitude,
longitude`` or ``near`` should be provided.
:param longitude: Search near this latitude. Note either ``latitude,
longitude`` or ``near`` should be provided.
:param near: Search near this place (e.g. "Chicago, IL" or "Amsterdam,
NL"). Note either ``latitude, longitude`` or ``near`` should be
provided.
:param query: Search query (e.g. "coffee shops" or "restaurants").
:param limit: Maximum number of results.
:param categories: List of `category IDs <https://developer.foursquare.com/docs/resources/categories>`_
to be searched.
:param categories: List of `category IDs
<https://developer.foursquare.com/docs/resources/categories>`_ to be
searched.
:param radius: Search radius in meters.
:param open_now: Filter by open/not open now.
:param sort_by_distance: Sort by distance.
:param sort_by_popularity: Sort by popularity
:param price: Price ranges, within the range ``[1,2,3,4]``.
:param saved: Filter by saved/unsaved venues.
:return: A list of venues, as returned by the Foursquare API.
"""
@ -210,14 +166,6 @@ class FoursquarePlugin(RunnablePlugin):
args['ll'] = ','.join([str(latitude), str(longitude)])
if near:
args['near'] = near
if altitude:
args['alt'] = altitude
if latlng_accuracy:
args['llAcc'] = latlng_accuracy
if altitude_accuracy:
args['altAcc'] = altitude_accuracy
if section:
args['section'] = section
if query:
args['query'] = query
if categories:
@ -226,18 +174,8 @@ class FoursquarePlugin(RunnablePlugin):
args['limit'] = int(limit)
if radius:
args['radius'] = radius
if open_now is not None:
args['openNow'] = int(open_now)
if sort_by_distance is not None:
args['sortByDistance'] = int(sort_by_distance)
if sort_by_popularity is not None:
args['sortByPopularity'] = sort_by_popularity
if saved is not None:
args['saved'] = int(saved)
if price:
args['price'] = ','.join([str(p) for p in price])
url = self._get_url('venues/explore')
url = self._get_url('venues/search')
return (
requests.get(url, params=args, timeout=self._http_timeout)
.json()
@ -257,10 +195,13 @@ class FoursquarePlugin(RunnablePlugin):
"""
Get the trending venues around a location.
:param latitude: Search near this latitude. Note either ``latitude, longitude`` or ``near`` should be provided.
:param longitude: Search near this latitude. Note either ``latitude, longitude`` or ``near`` should be provided.
:param near: Search near this place (e.g. "Chicago, IL" or "Amsterdam, NL"). Note either
``latitude, longitude`` or ``near`` should be provided.
:param latitude: Search near this latitude. Note either ``latitude,
longitude`` or ``near`` should be provided.
:param longitude: Search near this latitude. Note either ``latitude,
longitude`` or ``near`` should be provided.
:param near: Search near this place (e.g. "Chicago, IL" or "Amsterdam,
NL"). Note either ``latitude, longitude`` or ``near`` should be
provided.
:param limit: Maximum number of results.
:param radius: Search radius in meters.
@ -300,131 +241,22 @@ class FoursquarePlugin(RunnablePlugin):
), f'Cannot parse object of type {type(t)} into datetime: {t}'
return t
@action
def time_series(
self,
venue_id: Union[str, List[str]],
start_at: Union[int, float, datetime.datetime, str],
end_at: Union[int, float, datetime.datetime, str],
) -> List[Dict[str, Any]]:
"""
Get the visitors stats about one or multiple venues over a time range. The user must be a manager of
those venues.
:param venue_id: Venue ID or list of IDs to get the stats for.
:param start_at: Stats start time. Can be a UNIX timestamp, a datetime object or an ISO format datetime.
:param end_at: Stats end time. Can be a UNIX timestamp, a datetime object or an ISO format datetime.
:return: A list of venues, as returned by the Foursquare API.
"""
if isinstance(venue_id, list):
venue_id = ','.join(venue_id)
args = {
'venueId': venue_id,
'startAt': self._parse_time(start_at),
'endAt': self._parse_time(end_at),
}
url = self._get_url('venues/timeseries')
return (
requests.get(url, params=args, timeout=self._http_timeout)
.json()
.get('response', {})
.get('venues', [])
)
@action
def stats(
self,
venue_id: str,
start_at: Union[int, float, datetime.datetime, str],
end_at: Union[int, float, datetime.datetime, str],
) -> List[Dict[str, Any]]:
"""
Get the stats about a venue over a time range. The user must be a manager of that venue.
:param venue_id: Venue ID.
:param start_at: Stats start time. Can be a UNIX timestamp, a datetime object or an ISO format datetime.
:param end_at: Stats end time. Can be a UNIX timestamp, a datetime object or an ISO format datetime.
:return: A list of venues, as returned by the Foursquare API.
"""
args = {
'startAt': self._parse_time(start_at).isoformat(),
'endAt': self._parse_time(end_at).isoformat(),
}
url = self._get_url(f'venues/{venue_id}/stats')
return (
requests.get(url, params=args, timeout=self._http_timeout)
.json()
.get('response', {})
.get('venues', [])
)
@action
def managed(self) -> List[Dict[str, Any]]:
"""
Get the list of venues managed by the user.
:return: A list of venues, as returned by the Foursquare API.
"""
url = self._get_url('venues/managed')
return (
requests.get(url, timeout=self._http_timeout)
.json()
.get('response', {})
.get('venues', [])
.get('items', [])
)
@action
def checkin(
self,
venue_id: str,
latitude: Optional[float] = None,
longitude: Optional[float] = None,
altitude: Optional[float] = None,
latlng_accuracy: Optional[float] = None,
altitude_accuracy: Optional[float] = None,
shout: Optional[str] = None,
broadcast: Optional[List[str]] = None,
) -> Dict[str, Any]:
"""
Create a new check-in.
:param venue_id: ID of the venue to check-in.
:param latitude: Check-in latitude.
:param longitude: Check-in longitude.
:param altitude: Check-in altitude.
:param latlng_accuracy: Latitude/longitude accuracy in meters.
:param altitude_accuracy: Altitude accuracy in meters.
:param shout: Add a custom message to the check-in.
:param broadcast: List of Visibility/share types of the check-in. Default: ``public``. Possible values are:
- ``private``
- ``public``
- ``followers``
- ``facebook``
- ``twitter``
:return: Foursquare API response.
"""
args = {'venueId': venue_id}
if latitude and longitude:
args['ll'] = ','.join([str(latitude), str(longitude)])
if altitude:
args['alt'] = str(altitude)
if latlng_accuracy:
args['llAcc'] = str(latlng_accuracy)
if altitude_accuracy:
args['altAcc'] = str(altitude_accuracy)
if shout:
args['shout'] = shout
if broadcast:
args['broadcast'] = (
','.join(broadcast) if isinstance(broadcast, list) else broadcast
)
url = self._get_url('checkins/add')
return (
@ -436,7 +268,7 @@ class FoursquarePlugin(RunnablePlugin):
def main(self):
while not self.should_stop():
checkins = self._get_checkins()
checkins = self._get_checkins(limit=20, offset=0)
if not checkins:
return