OJPLocationInformationRequest 2.0

<siri:RequestTimestamp>2024-11-26T16:03:09Z</siri:RequestTimestamp>

<siri:MessageIdentifier>LIR-1a</siri:MessageIdentifier>

Wo verschiedene Bezeichnungen üblich sind, kann nach allen gesucht werden. Es funktioniert z.B. sowohl die Suche nach “Basel” als auch “Bâle CFF”. Z.B. “Biel/Bienne” wird sowohl mit dem Request “Biel” als auch mit “Bienne” gefunden.

<InitialInput>
    <Name>Bern</Name>
</InitialInput>

<InitialInput>
    <GeoPosition>
        <siri:Longitude>8.5545</siri:Longitude>
        <siri:Latitude>47.365</siri:Latitude>
    </GeoPosition>
</InitialInput>

<GeoRestriction>
    <Circle>
        <Center>
            <siri:Longitude>8.5545</siri:Longitude>
            <siri:Latitude>47.365</siri:Latitude>
        </Center>
        <Radius>500</Radius>
    </Circle>
</GeoRestriction>

<InitialInput>
    <GeoRestriction>
        <Rectangle>
            <UpperLeft>
                <siri:Longitude>8.54</siri:Longitude>
                <siri:Latitude>47.37</siri:Latitude>
            </UpperLeft>
            <LowerRight>
                <siri:Longitude>8.57</siri:Longitude>
                <siri:Latitude>47.36</siri:Latitude>
            </LowerRight>
        </Rectangle>
    </GeoRestriction>
</ojp:InitialInput>

Achtung: Es können sowohl Didok-Codes wie auch SLOID übertragen werden im Request und Response.

<PlaceRef>
    <siri:StopPointRef>8530813</siri:StopPointRef>
    <Name>
        <Text>Zürich Kreuzplatz</Text>
    </Name>
</PlaceRef>

<PlaceRef>
    <StopPlaceRef>ch:1:sloid:30813</StopPlaceRef>
    <Name>
        <Text>Zürich Kreuzplatz</Text>
    </Name>
</PlaceRef>

<PlaceRef>
    <GeoPosition>
        <siri:Longitude>8.5545</siri:Longitude>
        <siri:Latitude>47.365</siri:Latitude>
    </GeoPosition>
    <Name>
         <Text>Zürich Kreuzplatz</Text>
    </Name>
</PlaceRef>

Es gibt die folgenden Typen (PlaceTypeEnumeration):

• stop
• address
• poi
• location
• topographicPlace

Die Hauptverwendung sind stop und location. POI wird mit der Zeit wichtiger werden (namentlich u.U. für Parkhäuser und Sharer).

Neu können Sharing-Fahrzeuge (E-Scooter, Fahrräder, Autos) und Ladestationen als POI abgerufen werden (siehe unter PointOfInterestFilter unten).

Für address muss zuerst mit generellem Input der genaue Name ermittelt werden. Dann muss genau mit diesem Namen und dem Type “address” gesucht werden. Erst dann kommt der Adresscode zurück. Dies ist aber ein Sonderfall, der normalerweise nicht verwendet werden sollte. Weder Addresscode noch TopographicPlaceRef haben eine sinnvolle Bedeutung ausserhalb der Suche im OJP.

<Type>stop</Type>

Siehe auch Abschnitt zu PtMode

<PtModes>
    <Exclude>true</Exclude>
    <PtMode>bus</PtMode>
    <siri:BusSubmode>localBusService</siri:BusSubmode>
</PtModes>

<TopographicPlaceRef>23011901:2</TopographicPlaceRef>

• Bei “Tag” immer “amenity”
• Bei “Value” wahlweise “escooter_rental”, “bicycle_rental”, “car_sharing” oder “charging_station”.

Achtung: Die Abfrage muss mit einer GeoRestriction (Circle oder Rectangle) kombiniert werden, und nicht mit Name, GeoPosition oder PlaceRef.

<PointOfInterestFilter>
    <PointOfInterestCategory>
        <OsmTag>
            <Tag>amenity</Tag>
            <Value>car_sharing</Value>
        </OsmTag>
    </PointOfInterestCategory>
</PointOfInterestFilter>

Wichtig: Zeichenketten wie “St. Gallen Haggen” und “St. Gallen, Haggen” sind für die Suche gleichwertig.

Wird eine Resultategruppe mit gleicher Wahrscheinlichkeit (>0.5) angeschnitten, so liefert der Server alle Resultate zurück. D.h. die effektive Anzahl der Resultate kann abweichen vom gewünschten Resultat. Der Grund liegt darin, dass bei NumberOfResults=1 und Eingabe “St. Gallen, Haggen” effektiv 2 Haltestellen zurückgeliefert werden müssen: “St. Gallen, Haggen” und “St. Gallen Haggen”.

<NumberOfResults>10</NumberOfResults>

<NumberOfResults>10</NumberOfResults>

<IncludePtModes>true</IncludePtModes>

<siri:ResponseTimestamp>2024-11-26T17:03:09.1542196+01:00</siri:ResponseTimestamp>

<siri:ResponseTimestamp>MENTZ</siri:ResponseTimestamp>

<siri:RequestMessageRef>d5e1d0e3-ba3c-4f3e-b068-105f4d001777</siri:RequestMessageRef>

<siri:DefaultLanguage>de</siri:DefaultLanguage>

<CalcTime>2</CalcTime>

Pro PlaceResult wird jeweils ein Place-Element zurückgegeben. Die Anzahl PlaceResults hängt mit den Anfrageparametern “NumberOfResults”, “NumberOfResultsAfter” und “NumberOfResultsBefore” zusammen. Wenn ohne diese Parameter angefragt wurde kann der Router die Anzahl selber bestimmen.

<PlaceResult>
    <Place>
        <StopPlace>
            <StopPlaceRef>8507000</StopPlaceRef>
            <StopPlaceName>
                <Text xml:lang="de">Bern</Text>
            </StopPlaceName>
            ...
            <TopographicPlaceRef>23006351:1</TopographicPlaceRef>
        </StopPlace>
        <Name>
            <Text xml:lang="de">Bern (Bern)</Text>
        </Name>
        <GeoPosition>
            <siri:Longitude>7.43913</siri:Longitude>
            <siri:Latitude>46.94883</siri:Latitude>
        </GeoPosition>
        <Mode>
            <PtMode>rail</PtMode>
        </Mode>
    </Place>
    ...
</PlaceResult>

<Complete>true</Complete>

<Probability>0.927999973</Probability>

<Mode>
    <PtMode>tram</PtMode>
    <siri:TramSubmode>cityTram</siri:TramSubmode>
</Mode>
<Mode>
    <PtMode>bus</PtMode>
    <siri:BusSubmode>localBus</siri:BusSubmode>
</Mode>

<StopPlace>
    <StopPlaceRef>8507483</StopPlaceRef>
    <StopPlaceName>
        <Text xml:lang="de">Spiez</Text>
    </StopPlaceName>
    <TopographicPlaceRef>23006768:5</TopographicPlaceRef>
</StopPlace>

Ein Ort mit einem Namen und einer ID.

<TopographicPlace>
    <TopographicPlaceCode>suburbID:8136088:6:Bernhardsdorf:5439812:10881110:MRCV</TopographicPlaceCode>
    <TopographicPlaceName>
         <Text xml:lang="de">Bernhardsdorf</Text>
    </TopographicPlaceName>
</TopographicPlace>

Das Feature wird im Moment nicht unterstützt.

<Place>
    <PointOfInterest>
        <PublicCode>72215</PublicCode>
        <PointOfInterestCategory>
            <OsmTag>
                <Tag>service</Tag>
                <Value>hairdresser</Value>
            </OsmTag>
        </PointOfInterestCategory>
        <TopographicPlaceRef>23006351:-1</TopographicPlaceRef>
    </PointOfInterest>
    <Name>
        <Text xml:lang="de">Hair (Bern)</Text>
    </Name>
    ...
</Place>

<Address>
    <Name>
        <Text xml:lang="de">Zürich, Staffelstrasse 12</Text>
    </Name>
    <PostCode/> <!-- empty tag -->
    <TopographicPlaceName>Zürich</TopographicPlaceName>
    <TopographicPlaceRef>23026261:1500000003</TopographicPlaceRef>
    <Street>Staffelstrasse</Street>
    <HouseNumber>12</HouseNumber>
</Address>

<Name>
    <Text xml:lang="de">Zürich</Text>
</Name>

<GeoPosition>
    <siri:Longitude>7.43165</siri:Longitude>
    <siri:Latitude>46.94308</siri:Latitude>
</GeoPosition>

<StopPlaceRef>8508052</StopPlaceRef

<StopPlaceName>
    <Text>Bern Tiefenau</Text>
</StopPlaceName>

<TopographicPlaceRef>23006351:1</TopographicPlaceRef>

<TopographicPlaceName>
    <Text xml:lang="de">Bernhardsdorf</Text>
</TopographicPlaceName>

<PointOfInterest>
    <PublicCode>75825</PublicCode>
    <PointOfInterestCategory>
        <OsmTag>
            <Tag>service</Tag>
            <Value>hairdresser</Value>
        </OsmTag>
    </PointOfInterestCategory>
    <TopographicPlaceRef>23006627:-1</TopographicPlaceRef>
</PointOfInterest>