Public Transit API Developer's Guide

Transit Coverage in Nearby Cities

User Story

The user wants to retrieve a list of cities with a transit network near Boston (40.7510, 73.9916), and details of public transit operators working within those cities.

Request

The query parameter center specifies the location of the search.

https://cit.transit.api.here.com/v3/coverage/city.json
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&center=42.3580,-71.0636

Response

The response to the request contains a list of cities with the following information:
  • name, longitude, and latitude for each city
  • distance in meters to the location in the request
  • country and state the city belongs to
  • number of transit lines and stops available in the city
  • operators providing the transit service in the city
{
  "Res": {
    "serviceUrl": "https://cit.transit.api.here.com/transit/v3/coverage/city.json",
    "Coverage": {
      "ref_time": "2017-03-01T11:20:23",
      "CityCount": {
        "TT": 559,
        "RT": 11,
        "SR": 160
      },
      "Cities": {
        "City": [
          {
            "updated": "2016-11-23T16:46:26",
            "name": "Boston",
            "created": "2016-11-23T16:46:26",
            "country": "United States",
            "state": "Massachusetts",
            "y": 42.35866,
            "x": -71.05674,
            "id": "drt2z",
            "display_name": "Boston, Massachusetts, USA",
            "distance": 568,
            "relevancy": 0.95,
            "Cvg": {
              "quality": 0.67,
              "lines": 283,
              "stops": 2126
            },
            "Operators": {
              "Op": [
                {
                  "name": "Plymouth & Brockton Street Railway Co.",
                  "type": "TT",
                  "code": "55y0PB00",
                  "Link": [
                    {
                      "id": "website",
                      "href": "http://www.p-b.com/",
                      "text": "Plymouth & Brockton Street Railway Co."
                    }
                  ],
                  "At": {
                    "phone": "508-746-0378"
                  }
                },
                {
                  "name": "Brockton Area Transit Authority",
                  "type": "TT",
                  "code": "4AD44400",
                  "Link": [
                    {
                      "id": "website",
                      "href": "http://www.ridebat.com/",
                      "text": "Brockton Area Transit Authority"
                    }
                  ],
                  "At": {
                    "phone": "508-588-1000"
                  }
                },

                ... more links ...

                {
                  "name": "Salem Ferry",
                  "type": "TT",
                  "code": "4APSAL00",
                  "Link": [
                    {
                      "id": "website",
                      "href": "http://www.salemferry.com/",
                      "text": "Salem Ferry"
                    }
                  ]
                }
              ]
            },
            "pop": 599351
          },
          {
            "updated": "2016-11-23T16:46:26",
            "name": "Cambridge",
            "created": "2016-11-23T16:46:26",
            "country": "United States",
            "state": "Massachusetts",
            "y": 42.36679,
            "x": -71.10601,
            "id": "drt3j",
            "display_name": "Cambridge, Massachusetts, USA",
            "distance": 3616,
            "relevancy": 0.0,
            "Cvg": {
              "quality": 0.8,
              "lines": 43,
              "stops": 271
            },
            "Operators": {
              "Op": [
                {
                  "name": "MBTA",
                  "type": "TT",
                  "code": "3QT00100",
                  "Link": [
                    {
                      "id": "website",
                      "href": "http://www.mbta.com",
                      "text": "MBTA"
                    }
                  ],
                  "At": {
                    "phone": "617-222-3200"
                  }
                },
                {
                  "name": "128 Business Council",
                  "type": "TT",
                  "code": "bH512800",
                  "Link": [
                    {
                      "id": "website",
                      "href": "http://www.128bc.org/",
                      "text": "128 Business Council"
                    }
                  ],
                  "At": {
                    "phone": "781-890-0093"
                  }
                }
              ]
            },
            "pop": 101388
          },

          ... more lines ...

          {
            "updated": "2016-11-23T16:46:26",
            "name": "Hartford",
            "created": "2016-11-23T16:46:26",
            "country": "United States",
            "state": "Connecticut",
            "y": 41.76349,
            "x": -72.67402,
            "id": "drkmd",
            "display_name": "Hartford, Connecticut, USA",
            "distance": 148379,
            "relevancy": 0.0,
            "Cvg": {
              "quality": 0.8,
              "lines": 66,
              "stops": 1065
            },
            "Operators": {
              "Op": [
                {
                  "name": "Megabus",
                  "type": "TT",
                  "code": "gaW23100",
                  "Link": [
                    {
                      "id": "website",
                      "href": "http://us.megabus.com/Default.aspx",
                      "text": "Megabus"
                    }
                  ],
                  "At": {
                    "phone": "1 (877) 462-6342"
                  }
                },
                {
                  "name": "CTTransit- Hartford",
                  "type": "TT",
                  "code": "43t15500",
                  "Link": [
                    {
                      "id": "website",
                      "href": "http://www.cttransit.com",
                      "text": "CTTransit- Hartford"
                    }
                  ],
                  "At": {
                    "phone": "860-525-9181"
                  }
                },
                {
                  "name": "CTTransit- New Britain-Bristol",
                  "type": "TT",
                  "code": "5wR00400",
                  "Link": [
                    {
                      "id": "website",
                      "href": "https://www.cttransit.com",
                      "text": "CTTransit- New Britain-Bristol"
                    }
                  ],
                  "At": {
                    "phone": "860-828-0512"
                  }
                },
                {
                  "name": "Peter Pan Bus Lines",
                  "type": "TT",
                  "code": "55tPet00",
                  "Link": [
                    {
                      "id": "website",
                      "href": "http://peterpanbus.com/",
                      "text": "Peter Pan Bus Lines"
                    }
                  ],
                  "At": {
                    "phone": "800-343-9999"
                  }
                }
              ]
            },
            "pop": 124563
          }
        ]
      }
    }
  }
}