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://..."
    }
  }
}