Date Acquired for Tile/Extent
Hi,
Our users are using the tile service for the latest imagery;
https://tiles.planet.com/basemaps/v1/latest-series
They need to be able to (preferably) see an overlay with the imagery acquired or easily see what dates the imagery was acquired.
Are there any options in the API to;
1) Get the date(s) acquired for a tile or extent
2) Get the quads for an extent?
This FAQ https://support.planet.com/hc/en-us/articles/213169607-How-can-we-interpret-image-file-names-and-ID-numbers- suggests the tiles have a quad naming convention of L{level}-{X}E-{Y}N but when I interogate the API it says "Invalid quadID"
Example;
If I could access the quad data via tile number that would suffice as I can already determine the tiles in the extent.
Thanks
-
Hi Trevor,
For the naming convention, it looks like you're mixing docs for the old v0 api from several years ago with the current api. The v1 api uses the convention "X-Y" for quad names.
The support article you referenced describes the downloaded file name, not the quad ID. Also, the example quad it gives would be somewhere near the north pole for any recent mosaic.
We'll try to make the documentation clearer around that detail. However, it's best practice to list quad IDs through the api, rather than assuming that a particular quad ID will refer to the same area in all mosaics. Some mosaics use smaller quads, which leads to different quad IDs for same geographic region. Similarly, not all mosaics are at zoom level 15, and the quad ID is tied to the zoom level.
To get the quad IDs for an AOI, use the bbox argument to the quads endpoint. E.g.
To get the contributing scenes for a specific quad listed there, use the "items" link returned, or construct it based on the "id" using the items endpoint. E.g.:
Also note that there's a python-based cli client, so the equivalent operation in it to list quads in an AOI is:
planet mosaics search global_monthly_2019_08_mosaic --bbox="-88,35,-87,36"
And to get contributing scene info for a specific quad:
planet mosaics contribution global_monthly_2019_08_mosaic 529-1236
There are more examples for working with the mosaics api through the python client's cli in the planet-client-python docs.
Hope that helps!
-Joe
-
Also, if you'd prefer, there's the pixprov endpoint to the tileserver, which serves out pixel-level contributing scene information for webtiles. (i.e. 256x256 tiles, not quads) It returns a utfgrid response.
For example:
Note that the x and y coords specified there (7350 and 14290) are webtile coordinates which differ significantly from mosaic quad IDs.
Please sign in to leave a comment.
Comments
2 comments