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

Link to this

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.

Link to this

From: Pareesha Mehta-Wilson
Wellington Regional Council


Attachment image001.png
21K Download


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

Link to this

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

Link to this

From: Alice Clark
Wellington Regional Council


Attachment image003.png
30K Download

Attachment 2020 179 response.pdf
223K Download View as HTML


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

Link to this

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

Link to this

From: Pareesha Mehta-Wilson
Wellington Regional Council


Attachment image001.png
21K Download


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

Link to this

From: Pareesha Mehta-Wilson
Wellington Regional Council


Attachment image003.png
21K Download


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

Link to this

Things to do with this request

Anyone:
Wellington Regional Council only: