/journeys doesnt take destination name

[nanocraftmr]

i want to give the journeys endpoint the destination name: "to.name = Köln hbf" and not the id code from the station with "to=1389212" .

Im using Insomnia to test it.

In the documentation it seems to be possible, but it doesnt work.

Am i doing something wrong or is this feature not working right now?

Thanks for helping

[derhuerst]

With each of the mentioned options (stop/station ID, POI, address), you need to provide every listed field.

In the documentation it seems to be possible, but it doesnt work.

I think we should clarify the documentation, because it misled you. How would you like it to be phrased?

[nanocraftmr]

https://v6.db.transport.rest/api.html#get-journeys

by the api documentationi thought i can give it "to.name" (station name) instead of the bahn station id. As a user would want to search for connections from station to station and doesnt know the id.

am i using the api wrong or is it broken? when i just pass the name it says it needs an destination

[derhuerst]

If you want to pass a POI, you'll have to pass all of the enumerated parameters; This is a limitation of the underlying HAFAS API. We should make this clear in the docs.

You can find POIs by using /locations?query=…&stops=false&addresses=false (or /locations/nearby).

[nanocraftmr]

Thanks for the quick help. Love your work 👏

[derhuerst]

Others likely also had this question, let's improve the docs.

[derhuerst]

Can you submit a PR that improves the phrasing?

The example is here:

db-rest/build/api-docs.js

Lines 58 to 65 in d53ff22

	'/journeys': `\
	Uses [\`hafasClient.journeys()\`](https://github.com/public-transport/hafas-client/blob/6/docs/journeys.md) to **find journeys from A (\`from\`) to B (\`to\`)**.
	\`from\` (A), \`to\` (B), and the optional \`via\` must each have one of these formats:
	- as stop/station ID (e.g. \`from=8010159\` for *Halle (Saale) Hbf*)
	- as a POI (e.g. \`from.id=991561765&from.latitude=51.48364&from.longitude=11.98084&from.name=Halle+(Saale),+Stadtpark+Halle+(Grünanlagen)\` for *Halle (Saale), Stadtpark Halle (Grünanlagen)*)
	- as an address (e.g. \`from.latitude=51.25639&from.longitude=7.46685&from.address=Hansestadt+Breckerfeld,+Hansering+3\` for *Hansestadt Breckerfeld, Hansering 3*)