[Realtime-feed-users] Are product feeds documented anywhere?

[Fee, Jeremy M]

Hello,

We have some documentation at https://usgs.github.io/pdl/userguide/products/<https://gcc02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fusgs.github.io%2Fpdl%2Fuserguide%2Fproducts%2F&data=04%7C01%7Crealtime-feed-users%40geohazards.usgs.gov%7Cb5b0350915ed47cf7cbe08d95eb67505%7C0693b5ba4b184d7b9341f32f400a5494%7C0%7C0%7C637644959996707283%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=QS0YTdkIhHpshzIVqTuBg991nS4J13SOVS25MWbOWo0%3D&reserved=0> , which doesn't get into a lot of detail for contents , and some products like ShakeMap have more robust documentation https://usgs.github.io/shakemap/<https://gcc02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fusgs.github.io%2Fshakemap%2F&data=04%7C01%7Crealtime-feed-users%40geohazards.usgs.gov%7Cb5b0350915ed47cf7cbe08d95eb67505%7C0693b5ba4b184d7b9341f32f400a5494%7C0%7C0%7C637644959996717239%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=lapSN2%2BkfD2ScJiGHYB1UrW7hHhvmk4cyeVUmStKmdc%3D&reserved=0> (contents are in there somewhere).

Open to suggestions on where best to host that and how it might be laid out.  It will be a work in progress for a while, but something I'll continue to push for as we update that service for the cloud.


Thanks,

Jeremy Fee (he/him)
Computer Scientist
USGS Geologic Hazards Science Center, Golden, CO


________________________________
From: Realtime-feed-users <realtime-feed-users-bounces at geohazards.usgs.gov> on behalf of Haefner, Scott <shaefner at usgs.gov>
Sent: Thursday, August 12, 2021 14:34
To: realtime-feed-users at geohazards.usgs.gov <realtime-feed-users at geohazards.usgs.gov>
Subject: [Realtime-feed-users] Are product feeds documented anywhere?

Hi,

I am looking for documentation on the various product feeds, like the docs for the "GeoJSON Detail<https://earthquake.usgs.gov/earthquakes/feed/v1.0/geojson_detail.php>" feeds. Specifically, I am looking for docs on the PAGER cities feed, but it would be very useful to review documentation for all the various product feeds.

I noticed an inconsistency in the PAGER cities feed that is causing parsing errors in my application. See:

https://earthquake.usgs.gov/realtime/product/losspager/us6000f48v/us/1628790691210/json/cities.json

and

https://earthquake.usgs.gov/product/losspager/us10008ls4/us/1500437563792/json/cities.json

I noticed the URLs are a different format, but both came from the corresponding Event's "Detail" feed. In one case, the cities are keyed by "all_cities" and "onepager_cities". In the other, they aren't keyed at all and (I assume) that the list is for "onepager_cities".

I would like to proactively address other similar potential parsing errors, but it's impossible without access to the docs. I looked around and can't find them...can you please point me in the right direction?

Scott


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://geohazards.usgs.gov/pipermail/realtime-feed-users/attachments/20210813/d3d8e738/attachment.html>