Places (Search) API Developer's Guide

Browse-Pt-Stops Entrypoint

Note: The Browse Public Transport (PT) Stops Entrypoint is deprecated. Please use The Public Transit API

The Browse Public Transport (PT) Stops Entrypoint allows users to request public transit stops that are within two kilometer radius from the given location.

The results returned are sorted by increasing distance from the given location.

The location context might be an explicitly given location or it might be implicitly defined by a user’s current position.

The Browse-Pt-Stops Entrypoint is a Places (Search) API Core entrypoint.

Entrypoint URI

/browse/pt-stops

Entrypoint Parameters

Parameter Type Description
at Position (format: latitude,longitude[;cgen=(map|gps|sgps)][;u=\d+]); required, unless one of the Geolocation or X-Map-Viewport headers or the in are set. Coordinates of search location expressed as latitude, longitude. Additional parameters can be passed which provide more context such as the uncertainty and how the coordinates were generated. For example, "52.5304417,13.4111201", "52.5304417,13.4111201;cgen=gps;u=100" or "52.5304417,13.4111201;u=100". For a full description, see the Location Contexts documentation.

GET Method

The GET method provides access to public transport stops for the given location context.

Response Media Type

Responses to requests to this endpoint will have the urn:nlp-types:search media type. See the urn:nlp-types:search media type documentation for details about the structure and content of the response.

Request Example

https://places.cit.api.here.com/places/v1/browse/pt-stops
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&at=52.531,13.3848
&pretty

Response Example

{
  "results": {
    "items": [
      {
        "position": [
          52.520551,
          13.380001
        ],
        "distance": 69,
        "title": "Marschallbrücke",
        "category": {
          "id": "public-transport",
          "title": "Public Transport",
          "href": "http://...",
          "type": "urn:nlp-types:category",
          "system": "places"
        },
        "icon": "http://...",
        "vicinity": "Luisenstraße 32<br/>10117 Berlin<br/>Germany",
        "having": [],
        "type": "urn:nlp-types:place",
        "href": "https://...",
        "id": "pt-dmVyc2lvbj0xO2xhdD01Mi41MjA1NTE7bG9uPTEzLjM4MDAwMTtjYXRlZ29yeUlkPXB1YmxpYy10cmFuc3BvcnQ7aWQ9dmJiXzkxMDA1MjA",
        "transitLines": {
          "text": "Bus TXL",
          "label": "Transport lines",
          "lines": {
            "Bus TXL": {
              "name": "Bus TXL",
              "category": {
                "id": "5",
                "title": "Bus"
              },
              "style": {
                "color": "#7D176B",
                "textColor": "#FFFFFF",
                "iconShape": "rectangle"
              }
            }
          },
          "destinations": [
            {
              "destination": "Flughafen Tegel Airport",
              "line": "Bus TXL"
            },
            {
              "destination": "S+U Alexanderplatz",
              "line": "Bus TXL"
            }
          ]
        }
      },
      {
        "position": [
          52.522427,
          13.378675
        ],
        "distance": 209,
        "title": "Karlplatz",
        "category": {
          "id": "public-transport",
          "title": "Public Transport",
          "href": "http://...",
          "type": "urn:nlp-types:category",
          "system": "places"
        },
        "icon": "http://...",
        "vicinity": "Reinhardtstraße 45<br/>10117 Berlin<br/>Germany",
        "having": [],
        "type": "urn:nlp-types:place",
        "href": "http://...",
        "id": "pt-dmVyc2lvbj0xO2xhdD01Mi41MjI0Mjc7bG9uPTEzLjM3ODY3NTtjYXRlZ29yeUlkPXB1YmxpYy10cmFuc3BvcnQ7aWQ9dmJiXzkxMDA1MDU",
        "transitLines": {
          "text": "Bus 147, Bus TXL",
          "label": "Transport lines",
          "lines": {
            "Bus 147": {
              "name": "Bus 147",
              "category": {
                "id": "5",
                "title": "Bus"
              },
              "style": {
                "color": "#7D176B",
                "textColor": "#FFFFFF",
                "iconShape": "rectangle"
              }
            },
            "Bus TXL": {
              "name": "Bus TXL",
              "category": {
                "id": "5",
                "title": "Bus"
              },
              "style": {
                "color": "#7D176B",
                "textColor": "#FFFFFF",
                "iconShape": "rectangle"
              }
            }
          },
          "destinations": [
            {
              "destination": "Fahrt endet hier",
              "line": "Bus 147"
            },
            {
              "destination": "Flughafen Tegel Airport",
              "line": "Bus TXL"
            },
            {
              "destination": "S Ostbahnhof",
              "line": "Bus 147"
            },
            {
              "destination": "S Ostbahnhof",
              "line": "Bus 147"
            },
            {
              "destination": "S+U Alexanderplatz",
              "line": "Bus TXL"
            },
            {
              "destination": "S+U Berlin Hauptbahnhof",
              "line": "Bus 147"
            },
            {
              "destination": "S+U Brandenburger Tor",
              "line": "Bus 147"
            },
            {
              "destination": "S+U Brandenburger Tor/Glinkastr.",
              "line": "Bus 147"
            },
            {
              "destination": "S+U Hauptbahnhof",
              "line": "Bus 147"
            },
            {
              "destination": "U Märkisches Museum",
              "line": "Bus 147"
            },
            {
              "destination": "U Märkisches Museum",
              "line": "Bus 147"
            }
          ]
        }
      }
      .
      .
      .
    ]
  }
  "search": {
    "context": {
      "location": {
        "position": [
          52.521,
          13.3807
        ],
        "address": {
          "text": "Luisenstraße 35<br/>10117 Berlin<br/>Germany",
          "house": "35",
          "street": "Luisenstraße",
          "postalCode": "10117",
          "district": "Mitte",
          "city": "Berlin",
          "county": "Berlin",
          "stateCode": "Berlin",
          "country": "Germany",
          "countryCode": "DEU"
        }
      },
      "type": "urn:nlp-types:place",
      "href": "http://..."
    }
  }
}

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.