Skip to main content

PRODUCT UPDATES
IDEAS
GROUPS

Home
Community overview
Planet Products
APIs

APIs

Programmatically search, download, and transform data with Planet’s APIs, built on REST, JSON, and HTTP standards.

42 Topics
114 Replies

When you subscribe we will email you when there is a new topic in this category

42 Topics

nsruiz00‎‎ 🌱

Expected Time for Downloading Batch

Hello Planet community! I am looking to perform my first batch download and am wondering if it’s possible to get a ballpark estimate of how long this will take. I have a script prepared in Python using Planet’s API that will facilitate the retrieval and download of about 240 images from PSScene (3m resolution). To anyone with experience doing this, how long will this download process take? Should I run it before going to bed to give it enough time, or is it more recommended to try a parallel processing approach? Any tips are appreciated.

brunj7‎‎ 🌱

How to a I create a Geometry Filter from geojson file in Python?

Hi,Is there a way to create a Geometry Filter using defining the AOI directly from a geojson file in Python (ideally using geopandas)? The only examples I am seeing in tutorials is about copy-pasting coordinates, but I hope there is a more automated way to do this.Thank you!

emerysilb‎‎ 🌱

Education and research XYZ tile server low resolution and downloads credit

Only zoom tiles load atHi,I’m trying to implement the tile server using the education and research license, but it only seems to show a low resolution version of the data. What’s the process to load the full resolution tiles? Also, I tried using the API to get 13 acres of data using a clip in the API for the AOI, but it used about half my Downloads Scene credit. Is it possible to collect data without having the entire tile count against credit used? Thank you!

matt.ballardPlaneteer 🌎

Analyze Planet Data with R and the Statistical API

R is a powerful statistical data analysis tool. Planet data like PlanetScope or Forest Carbon are datasets which are well suited for statistical analysis because they are multi-temporal with many observations; daily in the case of PlanetScope and yearly in the case of Forest Carbon Diligence.When analyzing how locations have changed over time, one method is to calculate zonal statistics over specific areas of interest to summarize a value, such as index (e.g. NDVI) or Aboveground Carbon Density for Forest Carbon. To extract zonal statistics from Planet datasets, you can use the Statistical API.Using the Statistical API to extract statistical information is a great way to speed up analyses in R. You can calculate zonal statistics for long time series over many areas using cloud computing. You don’t need to download any images to do this, you only will be downloading summary statistics, so you can focus on doing statistical analysis in R.The Statistical API works on data that is store

DTBeard‎‎ 🌱

Interpreting /stats responses

Newby-question here: /stats returns often show millions of “counts” for my searches. for example:{ "count": 10181598, "start_time": "2016-01-01T00:00:00.000000Z" },Compared to the planet explorer GUI online results with what is (I assume) the same filters, this is an extraordinary difference. I imagine that some of the metadata type files are also included in the “count” in this example, but it still seems like a very high number for my search criteria (which included, for this example, included item_type, permission, publishing, cloud, daterange, and geometry filters all fairly strict). How should I interpret the “count” value from the endpoint response? Are there indeed over 10 million images that meet this criteria? Here is the filter structure for this search: # Search filter setupitem_type = ["PSScene"]AssetFilter = { "type": "AssetFilter", "config": ["ortho_analytic_4b", "ortho_analytic_4b_sr"]}PublishingFilter = { "type": "StringInFilter", "field_name":

edsfernandes‎‎ 🌱

Finding basemap by mosaic_id but not by its name

I have a code that searches for the most recent basemap available.However, when I list all available mosaics, it only returns mosaics until the end of 2023. When I search by name, for example "planet_medres_normalized_analytic_2024-09_mosaic" I can't find this basemap, but when I search directly by its id, I can find it: {'_links': {'_self': 'https://api.planet.com/basemaps/v1/mosaics/02e1d63d-21d6-4355-beed-504c8e3595db?api_key='', 'quads': 'https:/ /api.planet.com/basemaps/v1/mosaics/02e1d63d-21d6-4355-beed-504c8e3595db/quads?api_key=''&bbox={lx},{ly},{ux},{uy}', 'tiles ': 'https://tiles.planet.com/basemaps/v1/planet-tiles/planet_medres_normalized_analytic_2024-09_mosaic/gmap/{z}/{x}/{y}.png?api_key=''}, 'bbox ': [-179.999999974944, -34.161818157002, 179.999999975056, 30.145127179625], 'coordinate_system': 'EPSG:3857', 'datatype': 'uint16', 'first_acquired': '2024-09-01T0 0:00:00.000Z', ' grid': {'quad_size': 4096, 'resolution': 4.777314267823516}, 'id': '02e1d63d-21d6-4355-beed-

GabiZuccolotto24‎‎ 🌱

KeyError: 'id' when placing API order

Hello! I’m replicating the code found at this link https://github.com/planetlabs/notebooks/blob/master/jupyter-notebooks/Orders-API/ordering_and_delivery.ipynb with my own set of images and am receiving the error in the screenshot below when trying to place the order. For reference, I’m trying to pull all available analytic_8b_sr_udm2 products that overlap with my specified area of interest.I’m unsure if this is a problem with the API, the images I’m trying to order or the way I’ve written the code. My code is exactly the same as the one linked, except I performed a paginated quick search first and then copy and pasted the resulting item id list into the request code. That item id list has 786 image ids in it. Any insight someone can provide about what is causing this error and how to fix it would be so appreciated!

Lamirhl‎‎ 🌱

Clip tool to download images from API

Hello, everyone! I am downloading raster images clipped to 11 small aoi. It appears that my quota allocation is still counting the entire scene’s coverage area towards my monthly download quota, however. Does someone have script to make an order to download clipped images on aoi, for a time series. I will be very grateful as I tried and always get either errors or downloading the whole scenes which impact my monthly quota.Any info will be much appreciated.Thanks!

sbaglapl‎‎ 🌱

API Search only returns 250 ids

Hi, I am following the tutorial here to search for images lying within a bounding box. I only get 250 returns back for my aoi. Am I missing something? Please advise :) Cheers,Shashank

Nick Simonian‎‎ 🌱

Question with planet image processing for NDVI

I have a question about how planet is processing NDVIs I can download a 4 or 8 band image from planet and then process it in Qgis using the NDVI formula (NIR-Red) / (NIR+Red) and get a nice looking NDVI.When I get the same image from the API and drag it into Qgis the image has much lower total reflectance its about 70% darker. For example in the hand processed image Low value Vs high value is .219 and .585 in the same image that is pulled from the API the value is -.04 and .268 In the subscription there is a line called bandmath. "type": "bandmath","parameters"": {"b1": "(b4-b3)/(b4+b3)"," "pixel_type": "32R"}} it looks like bandmath is running the same NDVI formula I am B4 is Nir and B3 is Red how am I getting such different values between the two processes and why is there negative values in every image I get? I have maybe once hand processed a good image that had a low of less than .12 ( a -.04 maybe) and never high much above .90 Any ideas what processing is going on with the plane

Dan Cogswell‎‎ 🌱

How to check if tile is available for zoom, x, y before making API call to get tile

We are loading PlanetScope and SkySat tiles into an application using Google Maps API V3. It automatically requests tiles via the Planet API based on zoom level and x and y values.Since Planet scenes may not take up the entire bounding box of the map, we are sometimes calling the API for x and y values that may not produce a tile.Is there a way of checking ahead of time whether a tile is available at the x and y location so as to reduce the calls to the Planet API if there is no tile there? We call the API on the server so as to hide the API key, then return the resulting PNG file to the browser.Many thanks for your help,Dan

it0to‎‎ 🌱

Best way to go about getting Satellite Imagery on more zoomed in areas of interest?

I am working on a project where I am using satellite imagery to get updates on a basin in Texas. What is the best satellite/service to use in order to get the most clear images returned? I have an Enterprise L Account with Planet. What API should I be using to get the images? What is the best way to make sure I get the most clear images. Anytime it is a bit too zoomed in the images are basically pixels.

galoalvarez‎‎ 🌱

Hi allmy users wants to start and make a imagery task by API.in task request API body they have to enter their PL_numberI am the admin. i want the users to find their PL_number by API. I only want to give them API and not users username and password and then they find PL_number by their API

Janne Jääskeläinen

Orderding multiple scenes clipped with multiple AOIs

Hi all,I'm building a dataset for training a CNN. For this I need to acquire about 1000 PS scenes clipped to a rather small area of interest (around 600x600m). I've got the item id's and corresponding AOIs as polygons for all the images I need. Since the AOI for each PS scene is so small I want to use the clipping tool from orders API to spare our quota.My question is this: What is the best way to order multiple scenes clipped by multiple areas of interest?I've already written code (in Python) to acquire the images by sending an order for each image separately, but this solution seems a bit "brute-forcy" to me. Is there some more elegant solution to this? I know it is possible to order multiple scenes clipped by a single AOI in a single order but is it possible to order multiple scenes clipped by multiple AOIs? Thanks for your help!

AlidadA‎‎ 🌱

Configs definition of keys (gte, gt, lt, lte, gsd ...)

Hi folks,I am working with the Data API and I have a question that is really not covered by documentation (https://developers.planet.com/docs/apis/data/searches-filtering/).What do these configs really mean (gte, gt, lt, lte, gsd...) ? Because some of them store not only one data type, for example lte:In the DateRangeFilter "lte":"2020-01-31T00:00:00Z", but in the RangeFilter it is a float - "lte":0.1, or even an integer (https://developers.planet.com/docs/apis/data/quick-saved-search/ or here https://developers.planet.com/docs/subscriptions/tools/). Thanks!

AndreaMelchiorre‎‎ 🌱

how to see all orders?

I created >100 orders using automatic scripts, but I can only retrieve 20 of them, the last 20. How can I see the rest of them? I get 20 orders both via the python Order API and the web browser….

AndreaMelchiorre‎‎ 🌱

What is the maximum number of concurrent Orders I can create?

I need to download a large number of products, I created a script using python API to launch many orders, but after a few orders it stopped with 400 error…. I was wondering what is the maximum number of orders I can queue?

belenfh‎‎ 🌱

Trying to access imagery outside of my Tier using the Subscription API

Hello Everyone! I am writing this post to ask if anyone knows what happens when you try to download imagery from outside of your signed Tier using the Subscription API. E.g. in my case, I have a contract that lets me download imagery for a given polygon from Japan (Tier 1), so if an user mistakenly tries to download data from, let’s say, the US, my subscription creation will fail and throw an error or will I be charged for this?I already read this documentation, however I could not find an explicit reference to this problem. Although, I am guessing I would get a 403 error (Unauthorized). I would appreciate it if someone could answer my question. Thanks in advance!

ZacharyBowyer‎‎ 🌱

How to request 4-band basemaps?

Hello, I am trying to figure out how to use either the basemaps api or the orders api to download polygon selections of basemaps. So far, I have this code: # Order api stuff for basemaps def download_basemap(self, session, request, download_location, file_prefix): #POST request to get data headers = {'content-type': 'application/json'} response = session.post(self.ORDERS_API_URL, data=json.dumps(request), headers=headers) print(response.json()) #Construct url for getting request status order_id = response.json()['id'] order_url = self.ORDERS_API_URL + '/' + order_id #Check request status, once it's done download data while(True): r = session.get(order_url) response = r.json() state = response['state'] print(state) end_states = ['success', 'failed', 'partial'] if state in end_states: break time.sleep(10) #Download data

belenfh‎‎ 🌱

Checking the quota my subscription will consume before creating it

I am writing this post because I want to know if there is any response parameter, API call or tool that you can use to know exactly how much quota will be consumed by my subscription.Of course, I could calculate the area in sq kms using python or any other programming language but I am concerned about the rounding up errors, so I would like to get the exact value from Planet’s side before actually creating the subscription. I have noticed that in planet explorer there are tools that measure the area of your AOI but I will use the Subscription API to get data of my AOI for over long periods of time programmatically, so I will not use planet explorer.Also, I have read that there is an API for generating reports, called the reports API, but the documentation about it was rather scarce (I do not know whether in the report the quota usage per subscription will be included as I cannot use it) and also these reports are generated after creating the subscriptions, so this does not answer my qu

EnglischKäseMensch‎‎ 🌱

What's the easiest way to download data over a long temporal range?

I'm new to PlanetScope and to mapping. My question is which is the easiest and most time efficient way to download my site data from Planet? I find using the Planet Explorer clear and easy to use, and it lets me clip the image data to just my sites, which is very good as it prevents me from going over my quota. However, I want to download the data for my sites across their whole temporal range (2016 to present day). As far as I can tell, the explorer won't let me do this easily as I have to manually click each scene and press the "load more" button.I've also tried using the official Planet plugin for QGIS. It is cool that it loads Planet data directly into QGIS, but I don't see any option to crop scenes down to just the pixels I want. I also don't see the option to bulk select scenes within a date range. Lastly, I've attempted to use the APIs that Planet provides, but this is challenging because I'm only familiar with the R programming language, so I keep encountering errors. Furthermo

lc94‎‎ 🌱

Optimizing CLI Workflow: how to ensure Full AOI Coverage for Downloaded Planet Images

Hello there!I'm currently in the process of learning how to utilize the Command Line Interface (CLI) for downloading Planet products.I've successfully managed to download images that pique my interest. However, I've encountered an issue where none of these images fully cover the area of interest (AOI) that I'm working with. Below are the commands I've been using:planet data filter --geom "map (1).geojson" --permission --std-quality | planet data search-create PSScene --name "my_search" --filter -planet data search-run 74abd968151f440b9541e077e1178e00 --limit 2planet data asset-activate PSScene 20230803_094757_15_248f ortho_analytic_8b_srplanet data asset-wait PSScene 20230803_094757_15_248f ortho_analytic_8b_sr && planet data asset-download PSScene 20230803_094757_15_248f ortho_analytic_8b_sr Do you know how can I ensure that my images are completely within my AOI?

jonjab‎‎ 🌱

sample R scripts?

I just started poking around looking for an R script to interact with the API.At a glance I found this: https://github.com/bevingtona/planetR Anyone else have something they’d care to share before I start hacking away at this?

Dante Abate‎‎ 🌱

Download and crop an image using the API and gdalwrap in python

Apologize for the question but i am a beginner in programming.I am trying to write a script in Python and automatically download and crop a specific area using gdalwarp (I tried with the clip tool without success: https://developers.planet.com/apis/orders/tools/#using-tools).Although being able to get a clipped image, this is simply a black thumbnail (840KB).The final goal would be just to download the cropped part.At the moment I am downloading the full image and it creates the thumbnail mentioned above.The coordinates were extracted with the geojson.io toolCould be the problem related with the coordinate system (although the clipped image is quite small and let me think the issue is something else). Could you please advice what am I doing wrong? Below the code section:# Clip the image using gldalwarpclip_output_image = os.path.join(save_folder, "clipped_" + filename)input_coordinates = "33.282952632083095, 34.94060635659089, 33.282952632083095, 34.94060635659089"# Define the target c

quanta‎‎ 🌱

Clip tool implementation to download from Subscription API

Regarding the issue with our trial access, I have a question. While testing the capabilities of the Data API, it seems that there was some confusion between the 'GeometryFilter' and the 'Clip' tool in the Subscription API. We mistakenly believed that the 'GeometryFilter' would act as a clip and only provide us with the area of interest within the filter coordinates. However, it appears that it directed us to download an entire Planet Scope scene instead.Could anyone please provide clarification or guidance on how we can address this issue?"

1
2

Page 1 / 2

Powered by Gainsight

Terms & Conditions

Sign up.

Already have an account? Login

Login with Planet Account

Login With Planet Account

Login to the Planet community

Login with Planet Account

Login With Planet Account

Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.

Enter your e-mail address

Back to overview

Scanning file for viruses.

Sorry, we're still checking this file's contents to make sure it's safe to download. Please try again in a few minutes.

OK

This file cannot be downloaded

Sorry, our virus scanner detected that this file isn't safe to download.

OK

Planet Monitoring

Planet Analytic Feeds

Planetary Variables

Planet Basemaps

Energy & Infrastructure

Forestry & Land Use

Finance & Insurance

Civil Government

US State and Local

Defense & Intelligence

Investors

Connect with Planet Partners

Become a Partner

Planet Esri Partnership

Certification Program

Customer Stories

Planet University

Developer Center

Explorer Log In

Planet Insights

© 2024 Planet Labs PBC. All rights reserved.
| Privacy Policy | California Privacy Notice | California Do Not Sell
Your Privacy Choices | Cookie Notice | Terms of Use