Metlink API Documentation
Andrew Lensen made this Official Information request to Wellington Regional Council
The request was successful.
From: Andrew Lensen
Dear Wellington Regional Council,
I am submitting this OIA request as a follow-up to the previous request (https://fyi.org.nz/request/11057-metlink...) which did not have the requested information provided. To aid in this, I have provided additional context and information so that you can ensure the appropriate person can answer this query.
There is an API that provides realtime information about public transport in Wellington
avaliable here https://www.metlink.org.nz/api/*. I am requesting all documentation for any API avaliable under the above url, for example (but not limited to):
https://www.metlink.org.nz/api/v1/FareZo...
https://www.metlink.org.nz/api/v1/StopSe...
https://www.metlink.org.nz/api/v1/StopDe...
https://www.metlink.org.nz/api/v1/StopNe...
https://www.metlink.org.nz/api/v1/Servic...
https://www.metlink.org.nz/api/v1/Servic...
An API is an Application Programming Interface (see https://en.wikipedia.org/wiki/Web_API) which can be used to automatically (with a computer program) receive information from a webserver. For example, https://www.metlink.org.nz/api/v1/StopSe... appears to list all stops which have "lambton" in their name. Such APIs are widely used throughout the web, including by users who wish to (for example) develop public transport routing and analysis applications.
Under the OIA, can you please provide all held information on this API, including the request and response formats, including, but not limited to: request structure and parameters; a list of API endpoints, and any other documentation on this API.
Yours faithfully,
Andrew Lensen
From: Darrell Young
Wellington Regional Council
Dear Andrew,
under the Local Government Official Information and Meetings Act 1987
Thank you for your email dated 6 November 2020, requesting information
regarding Metlink API documentation
Your request is being followed-up and a reply will be sent to you within
20 working days of the request being received.
Yours sincerely,
Darrell Young
for
Luke Troy
General
Manager
Strategy
Greater Wellington Regional Council
ATTENTION: This correspondence is confidential and intended for the named
recipient(s) only. If you are not the named recipient and receive this
correspondence in error, you must not copy, distribute or take any action
in reliance on it and you should delete it from your system and notify the
sender immediately. Unless otherwise stated, any views or opinions
expressed are solely those of the author, and do not represent those of
the organisation.
From: Pareesha Mehta-Wilson
Wellington Regional Council
Kia ora Andrew
Thank you for your request for “all held information on this API,
including the request and response formats, including, but not limited to:
request structure and parameters; a list of API endpoints, and any other
documentation on this API.”
The API you provided the link to ([1]https://www.metlink.org.nz/api/*) is
not intended for third party use as it can change without notice to meet
the operational needs of the Metlink website. The Metlink website is
currently being upgraded, and when the new website goes live in December
the API for the old website will be taken down.
However, there are new APIs that have been developed for public use. These
are currently available on the OpenData Platform, and you can register to
gain access at [2]https://OpenData.gw.govt.nz. Please note that as the new
Metlink website isn’t live yet there may be times when the OpenData site
is unavailable while we apply last minute changes.
Given this, would you like to continue with your original request for
information on the old API, or would you like the same information but for
the newly developed APIs?
Could you please let me know by Wednesday 18 November which option you
would like to progress with?
Kind regards
Pareesha Mehta-Wilson
Kaitohutohu| Policy Advisor
Metlink
Follow us online: [3]Facebook | [4]Twitter
To find out how to plan your journey, go to metlink.org.nz
[5]Metlink Co Branded logo
ATTENTION: This correspondence is confidential and intended for the named
recipient(s) only. If you are not the named recipient and receive this
correspondence in error, you must not copy, distribute or take any action
in reliance on it and you should delete it from your system and notify the
sender immediately. Unless otherwise stated, any views or opinions
expressed are solely those of the author, and do not represent those of
the organisation.
References
Visible links
1. https://www.metlink.org.nz/api/*
2. https://opendata.gw.govt.nz/
3. https://www.facebook.com/MetlinkOnOurWay/
4. https://twitter.com/metlinkwgtn
From: Andrew Lensen
Dear Pareesha Mehta-Wilson,
Many thanks for writing to clarify. Given the changes you highlighted, I would like to amend my request to instead provide the same information but for the newly developed APIs.
Yours sincerely,
Andrew Lensen
From: Alice Clark
Wellington Regional Council
Dear Mr Lensen
Attached is the response to your recent request for information.
Kind regards
Alice Clark
Kaiāwhina Matua ki te Kaiwhakahaere Matua Waka
Executive Assistant to General Manager Metlink
Metlink
L2, 15 Walter St, Te Aro, Wellington 6011 | PO Box 11646, Manners St,
Wellington 6142
Follow us online: [1]Facebook | [2]Twitter
To find out how to plan your journey, go to metlink.org.nz
ATTENTION: This correspondence is confidential and intended for the named
recipient(s) only. If you are not the named recipient and receive this
correspondence in error, you must not copy, distribute or take any action
in reliance on it and you should delete it from your system and notify the
sender immediately. Unless otherwise stated, any views or opinions
expressed are solely those of the author, and do not represent those of
the organisation.
References
Visible links
1. https://www.facebook.com/MetlinkOnOurWay/
2. https://twitter.com/metlinkwgtn
From: Andrew Lensen
Dear Alice Clark,
Thank you for the response. Unfortunately, The linked developer portal does not contain any published APIs --- after logging in, it states "No APIs Published. Your administrator hasn't added any APIs to your account. Please contact them to publish an API."
Can you please clarify where the publicly-accessible information that I requested is, as per your refusal under section 17(d) of the Local Government Official Information and Meetings Act 1987?
Yours sincerely,
Andrew Lensen
From: Pareesha Mehta-Wilson
Wellington Regional Council
Kia ora Andrew
Unfortunately the site is undergoing some last minute updates which has
caused it to go offline. As soon as it is back up and running I will let
you know.
Kind regards
Pareesha
Pareesha Mehta-Wilson
Kaitohutohu| Policy Advisor
Metlink
L2, 15 Walter St, Te Aro, Wellington 6011 | PO Box 11646, Manners St,
Wellington 614
Follow us online: [1]Facebook | [2]Twitter
To find out how to plan your journey, go to metlink.org.nz
[3]Metlink Co Branded logo
ATTENTION: This correspondence is confidential and intended for the named
recipient(s) only. If you are not the named recipient and receive this
correspondence in error, you must not copy, distribute or take any action
in reliance on it and you should delete it from your system and notify the
sender immediately. Unless otherwise stated, any views or opinions
expressed are solely those of the author, and do not represent those of
the organisation.
References
Visible links
1. https://www.facebook.com/MetlinkOnOurWay/
2. https://twitter.com/metlinkwgtn
From: Pareesha Mehta-Wilson
Wellington Regional Council
Kia ora Andrew
The OpenData Platform is back online at
[1]https://opendata.metlink.org.nz/. One thing to note is that to access
data from the APIs you have to press the subscribe button - there are
instructions here [2]https://opendata.metlink.org.nz/getting-....
Kind regards
Pareesha Mehta-Wilson
Kaitohutohu| Policy Advisor
Metlink
L2, 15 Walter St, Te Aro, Wellington 6011 | PO Box 11646, Manners St,
Wellington 614
Follow us online: [3]Facebook | [4]Twitter
To find out how to plan your journey, go to metlink.org.nz
[5]Metlink Co Branded logo
ATTENTION: This correspondence is confidential and intended for the named
recipient(s) only. If you are not the named recipient and receive this
correspondence in error, you must not copy, distribute or take any action
in reliance on it and you should delete it from your system and notify the
sender immediately. Unless otherwise stated, any views or opinions
expressed are solely those of the author, and do not represent those of
the organisation.
References
Visible links
1. https://opendata.metlink.org.nz/
2. https://opendata.metlink.org.nz/getting-...
3. https://www.facebook.com/MetlinkOnOurWay/
4. https://twitter.com/metlinkwgtn
Things to do with this request
- Add an annotation (to help the requester or others)
- Download a zip file of all correspondence
Offensive? Unsuitable?
Requests for personal information and vexatious requests are not considered valid requests for Official Information (read more).
If you believe this request is not suitable, you can report it for attention by the site administrators
Report this request
Moss Cantwell left an annotation ()
I don't think anything is live yet but i was able to access the dashboard by fixing the sign up button.
<button type="submit" name="signUpButton" class="btn btn-primary signUpButton submitButton-customizable" disabled="">Sign up</button>
removing the disabled="" allows you to create an account.
all of the example api endpoints return transport errors
Link to this