OJPLocationInformationRequest

<RequestTimestamp>2020-01-09T08:00:00Z</RequestTimestamp>

<MessageIdentifier>4711</MessageIdentifier>

Dove si usano più denominazioni, è possibile cercarle tutte. È possibile effettuare la ricerca sia per «Basilea» che per «Basilea FFS». Se le fermate sono inserite in più lingue, la funzione funziona anche se la ricerca è in una sola lingua. Ad esempio, «Biel» può essere trovato sia con la richiesta «Biel» che con «Bienne».

<ojp:InitialInput>
	<ojp:LocationName>Bern</ojp:LocationName>
</ojp:InitialInput>

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

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

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

Sono disponibili i seguenti tipi:

• stop
• indirizzo
• poi
• coord
• topographicPlace

Gli usi principali sono stop e coordina. I POI diventeranno più importanti con il tempo, come i parcheggi o le stazioni di ricarica.

I veicoli in condivisione (monopattino elettrico, biciclette, auto) e le stazioni di ricarica possono ora essere richiamati come POI (v. ojp:PointOfInterestFilter sotto).

Per l’adress occorre innanzitutto determinare il LocationName esatto con un inserimento generale. Poi occorre effettuare la ricerca con lo stesso nome e il tipo «address». Solo allora il codice di indirizzo ritorna. Si tratta però di un caso speciale che di norma non dovrebbe essere utilizzato. Né il codice di indirizzo né il TopographicPlaceRef sono rilevanti al di fuori delle ricerche nell’OJP.

<ojp:Type>stop</ojp:Type>

Sono disponibili i seguenti valori:

• originario
• tramite
• destinazione

Questa feature non è supportata.

Vedere anche il paragrafo relativo a Modalità Pt

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

Questa feature non è supportata.

<ojp:TopographicPlaceRef>23011901:2</ojp:TopographicPlaceRef>

• Per ojp:Tag sempre amenity
• Per ojp:Value a scelta escooter_rental, noleggio biciclette, carsharing oppure stazione_di_rica.

Attenzione: la query deve essere combinata con una GeoRestriction (Circle o Rectangle) e non con LocationName, GeoPosition o PlaceRef.

<ojp:PointOfInterestFilter>
  <ojp:PointOfInterestCategory>
    <ojp:OsmTag>
      <ojp:Tag>amenity</ojp:Tag>
      <ojp:Value>escooter_rental</ojp:Value>
    </ojp:OsmTag>
  </ojp:PointOfInterestCategory>
</ojp:PointOfInterestFilter>

Non implementato nell’attuale versione 1.0, in programma per una versione successiva

Importante: stringhe di caratteri come «St. Gallen Haggen» e «St. Gallen, Haggen» sono equivalenti per la ricerca.

Se viene intercettato un gruppo di risultati con la stessa probabilità (>0,5), il server restituisce tutti i risultati. Ciò significa che il numero effettivo di risultati può discostarsi dal risultato desiderato. Questo perché per NumberOfResults=1 e inserendo «St. Gallen, Haggen» devono essere restituite due fermate: «St. Gallen, Haggen» e «St. Gallen Haggen».

<NumberOfResults>10</NumberOfResults>

<IncludePtModes>true</IncludePtModes>

Si sconsiglia l’uso di questi dati, poiché non è chiaro quale id sia necessario.

Attenzione: È possibile trasferire sia i numeri DiDok che gli sloid in request e response. Vedi

<ojp:PlaceRef>
	<StopPointRef>ch:1:sloid:30813</StopPointRef>
	<ojp:LocationName>
		<ojp:Text>Zürich Kreuzplatz</ojp:Text>
	</ojp:LocationName>
</ojp:PlaceRef>

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

<ojp:PlaceRef>
	<ojp:GeoPosition>
		<Longitude>8.5545</Longitude>
		<Latitude>47.365</Latitude>
	</ojp:GeoPosition>
	<ojp:LocationName>
		<ojp:Text>Zürich Kreuzplatz</ojp:Text>
	</ojp:LocationName>
</ojp:PlaceRef>

<siri:ResponseTimestamp>2020-04-03T14:47:59Z</siri:ResponseTimestamp>

<siri:RequestMessageRef>756</siri:RequestMessageRef>

<siri:Status>true</siri:Status>

<ojp:CalcTime>939</ojp:CalcTime>

<ojp:Location>
	<ojp:StopPlace>
		<ojp:StopPlaceRef>ch:1:sloid:8052</ojp:StopPlaceRef>
		<ojp:StopPlaceName>
			<ojp:Text>Bern Tiefenau</ojp:Text>
		</ojp:StopPlaceName>
		<ojp:TopographicPlaceRef>23006351:1</ojp:TopographicPlaceRef>
	</ojp:StopPlace>
	<ojp:LocationName>
		<ojp:Text xml:lang="de">Bern Tiefenau (Bern)</ojp:Text>
	</ojp:LocationName>
	<ojp:GeoPosition>
		<siri:Longitude>7.45020</siri:Longitude>
		<siri:Latitude>46.97274</siri:Latitude>
	</ojp:GeoPosition>
</ojp:Location>

<ojp:Complete>true</ojp:Complete>

Il risultato è ordinato in ordine decrescente con la probabilità (il più rilevante prima).

La selezione dei migliori candidati per l’elenco dei risultati viene determinata dopo che il testo di input corrisponde all’intero set di dati. La probabilità viene determinata in base al numero di trigrammi corrispondenti in cui i termini possono essere scomposti e al resto che non corrisponde. In caso di corrispondenza completa, cioè senza risultato, si ha un risultato pieno e il candidato ottiene la probabilità massima 1. Se c’è ancora un risultato residuo, viene detratto un punteggio. I risultati così ottenuti possono essere successivamente influenzati da diversi criteri di valutazione, qualità e ordine di classificazione. Le corrispondenze possono essere modificate in base alla regione (codice comune), al tipo (fermata, indirizzo, luogo, POI ecc.), al mezzo di trasporto di servizio o a un valore di rilevanza.

<ojp:Probability>0.927999973</ojp:Probability>

<ojp:Mode>
	<ojp:PtMode>rail</ojp:PtMode>
	<siri:RailSubmode>unknown</siri:RailSubmode>
</ojp:Mode>
<ojp:Mode>
	<ojp:PtMode>bus</ojp:PtMode>
	<siri:BusSubmode>localBusService</siri:BusSubmode>
</ojp:Mode>

<ojp:StopPlace>
	<ojp:StopPlaceRef>ch:1:sloid:8052</ojp:StopPlaceRef>
	<ojp:StopPlaceName>
		<ojp:Text>Bern Tiefenau</ojp:Text>
	</ojp:StopPlaceName>
	<ojp:TopographicPlaceRef>23006351:1</ojp:TopographicPlaceRef>
</ojp:StopPlace>

Al momento nessuno dovrebbe arrivare.

Questa funzione non è al momento supportata.

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

<ojp:Address>
	<ojp:AddressCode>streetID:382:13:23006351:1:Sempachstrasse:Bern:Sempach-strasse::Sempachstrasse:3014:ANY:DIVA_SINGLEHOUSE:830639:6064058:MRCV:sbb</ojp:AddressCode>
	<ojp:AddressName>
		<ojp:Text xml:lang="de">Bern, Sempachstrasse 13</ojp:Text>
	</ojp:AddressName>
	<ojp:PostCode>3014</ojp:PostCode>
	<ojp:TopographicPlaceName>Bern</ojp:TopographicPlaceName>
	<ojp:TopographicPlaceRef>23006351:1</ojp:TopographicPlaceRef>
	<ojp:Street>Sempachstrasse</ojp:Street>
	<ojp:HouseNumber>13</ojp:HouseNumber>
</ojp:Address>

<ojp:LocationName>
	<ojp:Text xml:lang="de">Bernina Suot (Pontresina)</ojp:Text>
</ojp:LocationName>

L’esempio mostra cosa succede se non ci sono coordinate. La precisione è quindi impostata a metà della circonferenza del mondo. Cerchiamo naturalmente di evitare casi simili.

<ojp:GeoPosition>
	<siri:Longitude>0.0</siri:Longitude>
	<siri:Latitude>0.0</siri:Latitude>
	<siri:Precision>20000000</siri:Precision>
</ojp:GeoPosition>

<ojp:StopPlaceRef>ch:1:sloid:8052</ojp:StopPlaceRef>

<ojp:StopPlaceName>
	<ojp:Text>Bern Tiefenau</ojp:Text>
</ojp:StopPlaceName>

<ojp:TopographicPlaceRef>23006351:1</ojp:TopographicPlaceRef>