Inside NPR.org

Inside NPR
 

archive

Friday, January 16, 2009

In case you haven't seen my tweets about it yet, Inauguration Report is now live. We've managed to create a variety of ways for you to share your inauguration experiences, from text messaging to an iPhone app. CBS News and American University are also helping us promote the project.

We've created a couple of Web pages you'll want to check out. First, visit NPR's Inauguration Report hub for details on how to participate; there's also a widget there, displaying reports as they come in to us. You can also check out InaugurationReport.com, which displays a giant map of all the reports that have been geotagged.

If you're coming to the inauguration or will be involved in events in your community, feel free to start posting dispatches now. We've already gotten hundreds of submissions via Twitter, and other content is coming in as well. We really want to hear from you if you're making your way to DC, whether it's the joy of the road trip or the frustration of traffic gridlock. And on January 20th, we hope to get a ton of submissions, assuming the networks don't come crashing down from the strain.

Special thanks to Dave Troy, Andrew Turner. Nathan Freitas and Sze Wong for their spectacular coding work; David Johnson and Dan Farber for joining us in the editorial collaboration; and Nancy Scola and Allison Fine for taking the lead in pulling together the Vote Report team, which directly lead to the creation of this project. We couldn't have done it without you.

-- Andy Carvin

tags: , , ,

categories: Editorial, Mobile, Social Media

8:45 - January 16, 2009

 
Monday, January 12, 2009

As my previous post mentioned, we recently re-launched our Station Finder Map. This post will discuss in more detail how the map works. Now, to the guts...

The Underlying Data
The system has several underlying database tables, including zip codes, cities and station data. The zip code and city tables, in addition to containing information about the locations, also include the latitude and longitude for the centroid each location. These are pretty simple, flat tables that contain the approximately 41,000 zip codes and 150,000 cities in the United States.

The station tables, on the other hand, are much more complex. They contain all of the nearly 2000 stations that carry NPR programming (as well as their translators) along with a wide array of information about those stations, including licensee data and pertinent URLs associated with the station (e.g. their home page, schedule page, donation page, audio streams, RSS feeds and podcast feeds). These tables also include the latitude, longitude and broadcast power information for each antenna.

The broadcast power information tells us how far that antenna's broadcast signal can reach in each direction. Our data is broken up into 72 directions, starting with due north and shifting five degrees around the circle until we are back at due north. For each direction, our database contains five different ranges, detailing how far the antenna can reach in that given direction. The range itself determines two things. First, it tells us how far away you can be from the antenna and still hear its signal - this takes into account some impediments, such as mountains. The second thing it tells us is what the quality of the signal will be. The closer you are to the antenna, generally, the more clear the signal will be (although this is not always the case).

Finally, most of the data in these tables is publicly available in our recently launched Station Finder API (the coverage data is not available, but everything else is). The functionality of the map is driven off of the API.

How Does the Search Work?
At the core, the system works based on latitudes and longitudes. If you search the system by zip code or city/state, the system will convert the search term into a latitude and longitude before looking for stations. Similarly, when you look for NPR stations along a driving route, the system identifies a series of points along the route and converts those points into latitudes and longitudes. The waypoints for driving routes include any turn, crossing of a border, start and end points, and some artificially inserted points that we create. (Searches based on call letters bypass the geo-searches and hits the station tables directly.)

Once we have the latitude and longitude, we perform a series of calculations based on the Great Circle Calcuation (GCC), which helps us to determine distances on a curved surface (ie. the Earth - and we are assuming that it is not flat). Using the GCC, we look for stations near the latitude and longitude, based on a 100 mile radius from that point. From that list of stations, which is too inclusive, we start our process of narrowing down the results to the actual stations that can be heard.

For each station returned from our initial search, we first determine the direction (one of the 72 described earlier) from the antenna to the requested latitude/longitude. Then we find out the distance between the antenna and the latitude/longitude using the GCC. Once we have the distance and the direction, we simply need to do a lookup in our database to determine if the broadcast distance of the station is greater than the distance between the antenna and the latitude/longitude. If the broadcast distance is greater, then the station can be heard in the latitude/longitude. If it is not, then the station cannot be heard.

Now, when I say "check to see if the broadcast distance is greater", we are really checking five different broadcast distances in the database. We do this to find out what the quality of the broadcast signal will be for that latitude/longitude. The further the distance, assuming it is still within range, the more likely the signal will worsen. There are other variables, but that is the basic idea.

Displaying on the Map
The display of this information on the map is pretty straight-forward. We simply drop an antenna icon at each latitude/longitude where a station's antenna is actually located. For that antenna, we use the polygon feature in Virtual Earth to draw and shade the coverage circles on the map. The contours of the coverage circles are drawn by taking the distance of the broadcast range in each of the 72 directions, drawing a line connecting the points, then shading in the circle. We do this for three of the five broadcast ranges in our database. The overlay of the shading for each of these three circles results in the inner circle being darker than the middle circle, which is darker than the outer circle.

Other Notes
One other thing I should point out about this data is that it is great for the purposes of this type of application - a web-based service to inform our audience as to which NPR stations are available throughout the country. There are other more sophisticated, more precise ways to identify the station coverage maps which are really overkill for this type of service.

To see another representation of this same functionality, go to nprroadtrip.com. This is a map mashup produced by an NPR enthusiast (not affiliated with NPR).
--Daniel Jacobson

tags: ,

categories: Technology

3:57 - January 12, 2009

 
Sunday, January 11, 2009

When we first launched the NPR Community on September 28 of last year, we wondered how long it would take for us to reach 50,000 registered users, and a number of us figured it would take at least six months to reach that goal.

It turns out we were able to do it in four months.

A couple days ago on January 9, we hit the 50,000 mark. And we couldn't have done it with all of you. On behalf of the NPR Social Media Desk, I want to thank all of you who've taken the plunge with us. We're thrilled that we've reached this milestone so quickly.

So here's to reaching 100,000 users! Anyone want to take a guess at when we'll get there?

-- Andy Carvin

categories: Administrative Stuff, Social Media

8:52 - January 11, 2009

 
Friday, January 9, 2009



draft of Inauguration Report logo

A draft of one of the logos we're considering for the Inauguration Report project.


Source: Ben Kutil

As I mentioned last week, we've been brainstorming ways of using a variety of social media tools to collect stories from people related to President-elect Obama's inauguration. We're starting to make some good progress, so I wanted to post a quick update.

Dave Troy and Sze Wong have been working hard on an iPhone app. We're hoping it will be in the App Store before the end of next week so people can start using it the weekend prior to the inauguration. I'll let you know once it's live. Meanwhile, you can still start getting involved now by using our official tags whenever you post something online. If you're on Twitter, please use #dctrip09 if you plan to document your road-trip to DC. For inauguration day itself and any other inaugural-related activities, please use #inaug09. If you take a look at Twitter, there are already a number of people using the tag, which undoubtedly has also been boosted by the fact that Current.tv is promoting the same tag. So I'm keeping my fingers crossed that #inaug09 will be seen by many as the semi-official tag for the inauguration on Twitter - or at least as semi-official as tags ever get, of course.

Similarly, you can use the tags dctrip09 and inaug09 on lots of other sites, like Flickr, YouTube, Utterli, or in your blog posts. In these cases, there's no need to use the pound sign (#) before the tags, as the pound side is generally unique to twitter and other text messaging tools. By using these tags when you upload content, we'll be able to find it easily and display it on our site. I also hope to make the widgets we use available to everyone in case you want to embed a copy of them as well. There are also plenty of free widgets out there that would let you create your own widgets. Widgetbox.com, for example, has a large collection of them. We're still planning to build some widgets of our own, and could use a few more coders, so if you're good with Rails or Javascript, please let us know by posting a comment below or tweeting me at acarvin and we'll put you to work.

For those of you who aren't in to uploading photos, video, etc, you can still let us know about your travel plans to DC. We might even send over a reporter to talk to you about it. Please tell us about your plans either by posting a comment below or sending an email to homework@npr.org. (I'm not sure about the name for that email address, but that's the one we're using.) :-)

I'll definitely have lot more information to offer next week. Until then, let's get tagging!

-- Andy Carvin

tags: , , , , ,

2:25 - January 9, 2009

 
Wednesday, January 7, 2009

We've had a positive reception to the Mix Your Own Podcast tool launched December 18. Here are a few tips to help you get more out of this new feature.

Every Story is an Episode

Our traditional podcasts, launched in August 2005, often combine multiple stories in a single podcast episode. For example, the Economy podcast has episodes that typically contain 4 stories, delivered on Tuesday and Friday. With Mix Your Own Podcast, each story appears as its own episode. Here is a Mix Your Own version of the Economy podcast. This allows you to download the stories as soon as the audio is available on NPR.org, and it gives you more control over what you want to listen to.

However, if you set up a podcast on a popular topic, you may get several episodes per day, so you may want to adjust your podcast software to keep more episodes available. In iTunes, this is done by selecting the Podcast Tab and then clicking the Settings button on the lower left. You may also want to set your software to download episodes more frequently so that you get timely news as soon as it is available. Here are some suggested settings.

Click to enlarge

 

Refined Search

Mix Your Own Podcast finds stories relevant to your interests in one of two ways. First, NPR categorizes stories in many different ways: the program on which the story was aired/published, topics associated with the story, the reporters of the story, musical artists featured in the story, and so on. You can use any of these pre-existing categories to build your podcast. In the Mix Your Own Podcast tool, pre-existing categories will appear as you type in the keyword field. You can select these categories by clicking on them.

Mix Your Own Podcast drop down

 

Second, your podcast can be based on free text searches of the content of stories. Originally, this search was done on any text content found on the web page for the story as well as the audio transcripts for the stories (if available). While comprehensive, this can find stories that are only tangentially related to your keywords. For example, if you entered "Cat" as your keyword, your podcast could include stories where a reporter used the phrase "Let the cat out of the bag." So, we have changed the way text search is used in Mix Your Own Podcast; now, we will only search the title and the summary of the story. This should provide more relevant stories for your podcast. This change took place automatically, so you don't have to make any changes to your podcast to take advantage of it. However, if you liked the full text search, see the next tip.

Mix Tool for Power Users

You can still use the full text version of search to build your podcast via the API Query Generator. Mix Your Own Podcast is built on top of the NPR API. Using the Query Generator, you can fine tune the criteria used to pick stories for your podcast. To use the Query Generator, you will need to sign up for a free API Key. Then, in the Query Generator, go to the "Fields" tab and select "Podcast" as your "Output Format". You can then use the other tabs to customize your podcast to your heart's content.

Click to enlarge

For example, if you preferred the full text search option for building your podcast, go to the "Control" tab, type in your search terms, and select "Full Content of Story" as the "Search Type".

Another example of what you can do with the Query Generator is controlling how your selection criteria are combined. In the Mix Your Own Podcast tool, we return stories that match any of your specified criteria. If you enter several categories, the podcast will contain stories that match at least one of the criteria. In technical terms, we call this a "Boolean Or" API query. Perhaps, though, you want to combine your criteria to get a more focused podcast that contains only the stories that match all of the category selections you have made. For example, if I wanted a podcast that contained only stories that were about both Technology and Politics, I would go to the Query Generator "Topics" tab, check both the "Technology" and "Politics" options, and then go to the "Control" tab and select the "And" option for "Boolean for IDs" option.

Click to enlarge

The end result is my Techlogy and Politics custom podcast.

We would like to hear how you are using the Mix Your Own Podcast tool. If you have created an interesting custom podcast, please post the URL in the comments section of this post.

--Harold Neal

tags: , ,

categories: API

7:22 - January 7, 2009

 
Monday, January 5, 2009

I am happy to announce the re-release of our Station Finder Map, including our Road Trip functionality. This version includes several features worth noting, as follows:

- It allows you to identify local NPR station based on zip code, city/state, station call letters or by broadcasting network.

- It allows you to identify local NPR stations along a driving route.

- It allows you to identify local NPR stations that can be heard at a specific address.

- For stations returned by the finder, you can view the station's coverage map, view more information about the station, and click through to the stations' group page within the NPR Community.

- It is fully supported by our recently released Station Finder API.

We are very excited to have this feature back on the site and hope that it will help our listeners find NPR wherever they may go. In a later post, I will be providing a detailed technical explanation of how the Station Finder Map works.
--Daniel Jacobson

tags: , ,

categories: Technology

11:03 - January 5, 2009

 

About Inside NPR.org

Ever wanted to peer under the hood and learn about the inner workings of the NPR website? Have we got a blog for you, then. Here at Inside NPR.org, the NPR Digital Media team will keep you up-to-date on digital products and services we're developing, including social networking tools and our media player. For more info, please see our FAQ and our discussion rules.

search Inside NPR.org

Contact us

Got a question or comment you want to send to us privately? Use our contact form.