PastVu API

info

To retrieve a photo, you need to add the contents of the file field from the API method response to the URL:

• https://pastvu.com/_p/d/ for standard size;
• https://pastvu.com/_p/a/ for original size;
• https://pastvu.com/_p/h/ for thumbnail size.

The following methods are supported:

photo.giveForPage

Returns information about the photo by its number.

Parameter	Mandatory	Type	Description
cid	✓	int	unique photo number

Query example:

https://pastvu.com/api2?method=photo.giveForPage&params={"cid":5}

comment.giveForObj

Returns comment tree by photo number.

Parameter	Mandatory	Type	Description
cid	✓	int	unique photo number

Query example:

https://pastvu.com/api2?method=comment.giveForObj&params={"cid":23314}

photo.giveNearestPhotos

Returns an array of photos closest to the passed coordinate. The array is sorted in ascending distance order.

Parameter	Mandatory	Type	Default	Description
geo	✓	array [lat, lon]	coordinates
except		int		exclude cid photo from the output
distance		int	10000	maximum distance in meters (<= 1000km)
year	int		lower limit of the year of the photo
year2	int		upper limit of the year of the picture
type	string	photo or painting
limit	int	30	number of photos requested (<= 30)
skip	int		skip the specified number of photos from the beginning of the search result (for page output)

Query example:

https://pastvu.com/api2?method=photo.giveNearestPhotos&params={"geo":[37.82,-122.469322],"limit":12,"except":228481}

photo.getByBounds

Returns photos and clusters on the map by the passed zoom, GeoJSON object (Polygon or MultiPolygon) and optional year limit. The sequence of points in the array that forms the polygon must follow a counterclockwise path to sample objects within its boundaries (see RFC7946 3.1.6). The order of coordinates at points is [lon, lat]. From zoom 17 and up only photos are returned, for zoom level 16 and below both photos and clusters can be returned.

Parameter	Mandatory	Type	Default	Description
geometry	✓	GeoJSON (Polygon or MultiPolygon)	search area
z	✓	int		zoom level
isPainting		bool	0	return only pictures in the response
year		int		lower limit of the year of the photo
year2		int		upper limit of the year of the photo
localWork		bool	0	return array of photos (set 1 when using zoom value >= 17)

Query example:

https://pastvu.com/api2?method=photo.getByBounds&params={"z":11,"geometry":{"type":"Polygon","coordinates":[[[37.29034423828125,55.56902805913944],[37. 95501708984375,55.56902805913944],[37.95501708984375,55.92150795277898],[37.29034423828125,55.92150795277898],[37.29034423828125,55.56902805913944]]]}}