GW Course Schedule and Campus API

Course ScheduleGeorge Washington University recently released an iPhone app that allows students to look up the course schedule and each course’s open/closed status as well as browse an interactive map of the campus. Naturally, upon installing the app, the first thing to do is to try and ferret out the underlying XML API that powers it, a simple enough task given the right tools.

Below you can find the details on GW’s course schedule and campus map API endpoints, as well as an API wrapper to interact with it written in PHP. Feel free to grab the code below, or fork and contribute in the GitHub repo. Cool data that deserves to be shared with the world, no doubt.

Creative ideas on how best to leverage the information welcome in the comments below.

Please Note: I am not a GW employee, nor is use of the API explicitly authorized by the University. The code below is provided “as is” solely for educational purposes. If for any reason you would like this page removed, please contact me immediately and I will do so.


Course Schedule

  1. Departments
  2. Endpoint: http://my.gwu.edu/mod/pws/scheduleXML.cfm
  3. Parameters: termCode=[YYYY][01=spring, 02=summer, 03=fall]
  4. Returns

    <?xml version="1.0" encoding="iso-8859-1" ?>
    <departments>
      <department>
        <departmentcode><![CDATA[ACCY]]></departmentcode>
        <departmentname><![CDATA[Accountancy]]></departmentname>
      </department>
      <department>
        <departmentcode><![CDATA[AH]]></departmentcode>
        <departmentname><![CDATA[Art/Art History]]></departmentname>
      </department>
    </departments>
    
  5. Courses

    1. Endpoint: http://my.gwu.edu/mod/pws/scheduleXML.cfm
    2. Parameters:

      1. termCode=[YYYY][01=spring, 02=summer, 03=fall]
      2. deptCode=[Dept. Code]
    3. Returns:

      <?xml version="1.0" encoding="iso-8859-1" ?>
      <courses>
        <course>
          <coursedepartment><![CDATA[ACCY]]></coursedepartment>
          <coursenumber><![CDATA[6101]]></coursenumber>
          <coursecrn><![CDATA[55164]]></coursecrn>
          <coursetitle><![CDATA[FinAcctingI:BasicFinStatements]]></coursetitle>
          <courseinstructor><![CDATA[ Singleton, L]]></courseinstructor>
          <courselocation><![CDATA[<A HREF="http://www.gwu.edu/~map/building.cfm?BLDG=DUQUES" target="_blank" >DUQUES</a> 258]]></courselocation>
          <coursedays><![CDATA[MW 06:10PM - 09:05PM]]></coursedays>
          <coursetime><![CDATA[]]></coursetime>
          <coursestatus><![CDATA[OPEN]]></coursestatus>
          <coursesection><![CDATA[81]]></coursesection>
          <coursecredit><![CDATA[1.50  ]]></coursecredit>
        </course>
        <course>
          <coursedepartment><![CDATA[ACCY]]></coursedepartment>
          <coursenumber><![CDATA[6102]]></coursenumber>
          <coursecrn><![CDATA[55165]]></coursecrn>
          <coursetitle><![CDATA[Fin Accting II: FinAcc Choices]]></coursetitle>
          <courseinstructor><![CDATA[ Tarpley, R]]></courseinstructor>
          <courselocation><![CDATA[<A HREF="http://www.gwu.edu/~map/building.cfm?BLDG=DUQUES" target="_blank" >DUQUES</a> 258]]></courselocation>
          <coursedays><![CDATA[MW 06:10PM - 09:05PM]]></coursedays>
          <coursetime><![CDATA[]]></coursetime>
          <coursestatus><![CDATA[OPEN]]></coursestatus>
          <coursesection><![CDATA[80]]></coursesection>
          <coursecredit><![CDATA[1.50  ]]></coursecredit>
        </course>
      </courses>
      

    Campus Map

  6. Categories
  7. Endpoint: http://citl.gwu.edu/iphonedev/maps/categories.xml
  8. Return:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <categories xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <category>
            <categoryId>1</categoryId>
            <shortname>academic</shortname>
            <categoryName>Academic</categoryName>
            <state>Yes</state>
        </category>
        <category>
            <categoryId>2</categoryId>
            <shortname>administrative</shortname>
            <categoryName>Administrative</categoryName>
            <state>Yes</state>
        </category>
    </categories>
    
  9. Buildings

    1. Endpoint: http://citl.gwu.edu/iphonedev/maps/[shortname].xml
    2. Return:

      <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
      <buildings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <building>
            <buildingNumber>153</buildingNumber>
            <campus>Foggy Bottom</campus>
            <UsageClassification>Academic</UsageClassification>
            <buildingName>1776 G St</buildingName>
            <address>1776 G St</address>
            <geoLocation>38.897984,-77.04146</geoLocation>
            <shortname>NA</shortname>
            <picturelink><http://www.gwu.edu/~newsctr/mobile/images/maps/1776-G-ST_UP_WLA_2010-6618.jpg></picturelink>
        </building>
        <building>
            <buildingNumber>136</buildingNumber>
            <campus>Foggy Bottom</campus>
            <UsageClassification>Academic</UsageClassification>
            <buildingName>1957 E St</buildingName>
            <address>1957 E St</address>
            <geoLocation>38.896193,-77.044294</geoLocation>
            <shortname>1957E</shortname>
            <picturelink><http://www.gwu.edu/~newsctr/mobile/images/maps/Elliot_School_UP_WLA_2010-3102.jpg></picturelink>
        </building>
      </buildings>
      

API Wrapper

  1. Source
  1. Usage

Initialize

<?php $gwapi = new gw_api; ?>

List Departments

<?php
$departments = $gwapi->get_schedule();
foreach ($departments as $department)
echo $department->departmentname . '<br />';
?>

Get Course Schedule for Fall 2011

<?php $courses = $gwapi->get_schedule('2011','03','ACCY');?>

Get Course Schedule for current term

<?php $courses = $gwapi->get_schedule(null,null,'ACCY'); ?>

Get map categories

<?php $categories = $gwapi->get_map(); ?>

Get Buildings

<?php $buildings = $gwapi->get_maps('academic'); ?>

[Photo: atomicbartbeans]

benbalter

Named one of the top 25 most influential people in government and technology and Fed 50’s Disruptor of the Year, described by the US Chief Technology Officer as one of “the baddest of the badass innovators,” and winner of the Open Source People’s Choice Award, Ben Balter is a Product Manager at GitHub, the world’s largest software development network. Previously, Ben served as GitHub’s Government Evangelist, leading the efforts to encourage government at all levels to adopt open source philosophies for code, for data, and for policy development. More about the author →

This content is open source.
Please help improve it.