OJPLocationInformationRequest

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

<MessageIdentifier>4711</MessageIdentifier>

Se si utilizzano di solito diverse denominazioni, si possono cercare tutte. Funziona ad es. sia per «Basilea», sia per «Basilea FFS». Per le fermate con iscrizioni in più lingue, funziona anche effettuando la ricerca in una sola lingua. Ad es. «Biel/Bienne» viene trovato sia con la richiesta «Biel/Bienne» 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>

Esistono i tipi seguenti:

• stop
• indirizzo
• poi
• coord.
• topographicPlace

Gli usi principali sono stop e coord. poi diventerà più importante con il tempo (in particolare, in alcuni casi, per parcheggi e condivisioni).

Ora i veicoli in condivisione (monopattini elettrici, biciclette, auto) e le stazioni di ricarica possono essere visualizzati come POI (vedere ojp:PointOfInterestFilter sotto).

Per address, è necessario determinare il Nome Location esatto con un input generale. Quindi la ricerca deve essere effettuata con questo nome e tipo «address» (address). Solo a questo punto viene restituito il codice indirizzo. Si tratta tuttavia di un caso speciale, che normalmente non dovrebbe essere utilizzato. Né il codice indirizzo né il TopographicPlaceRef hanno significati significativi esterni alle ricerche in OJP.

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

I valori sono i seguenti:

• provenienza
• via
• di destinazione

Questa feature non è supportata.

Vedere anche paragrafo su PtMode

<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
• Presso ojp:Value è possibile scegliere tra escooter-rental, noleggio biciclette, car sharing oppure stazione_ricarica.

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, previsto in una versione successiva

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

Se viene toccato un gruppo di risultati con la stessa probabilità (>0,5), il server fornisce tutti i risultati. Ciò significa che il numero effettivo di risultati può differire dal risultato desiderato. Il motivo è che con NumberOfResults=1 e l’immissione «St. Gallen, Haggen» devono essere effettivamente riportate 2 fermate: «St. Gallen, Haggen» e «St. Gallen Haggen».

<NumberOfResults>10</NumberOfResults>

<IncludePtModes>true</IncludePtModes>

Si sconsiglia di usarli perché non è chiaro quale id sia necessario.

Attenzione: È possibile trasferire sia numeri DiDok che sloid in Request e Response. Vedere

<ojp:PlaceRef>
	<StopPointRef>8530813</StopPointRef>
	<ojp:LocationName>
		<ojp:Text>Zürich Kreuzplatz</ojp:Text>
	</ojp:LocationName>
</ojp:PlaceRef>

<ojp:PlaceRef>
	<ojp:StopPlaceRef>8530813</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>8508052</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 di probabilità decrescente (prima i più rilevanti).

La selezione dei migliori candidati per l’elenco dei risultati è determinata in base alla corrispondenza tra il testo di input e l’insieme dei dati. La probabilità è determinata in base al numero di trigrammi corrispondenti in cui i termini possono essere suddivisi e il resto che non corrisponde. In caso di corrispondenza completa, cioè senza resto, si ottiene un risultato completo e il candidato ottiene la massima probabilità 1. Se c’è ancora un risultato residuo, questo comporterà una detrazione di punti. I risultati così ottenuti possono essere influenzati in base a diversi criteri di valutazione, qualità e ordine di classificazione. I risultati possono essere modificati per regione (codice comunale), tipo (fermata, indirizzo, località, POI ecc.), mezzo di trasporto servito o 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>8508052</ojp:StopPlaceRef>
	<ojp:StopPlaceName>
		<ojp:Text>Bern Tiefenau</ojp:Text>
	</ojp:StopPlaceName>
	<ojp:TopographicPlaceRef>23006351:1</ojp:TopographicPlaceRef>
</ojp:StopPlace>

Al momento non dovrebbe arrivare nessuno.

Questa funzionalità non è attualmente 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>

Questa funzionalità non è attualmente supportata.

<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 viene restituito quando non ci sono coordinate. La precisione è quindi impostata a metà della circonferenza del mondo. Cerchiamo ovviamente di evitare questi casi.

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

<ojp:StopPlaceRef>8508052</ojp:StopPlaceRef>

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

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