Rhaglen API cynllun sgorio bwyd y DU

Mae'r data ar y sgoriau hylendid bwyd y DU a gyhoeddir ar https://ratings.food.gov.uk/cy ar gael drwy raglen API, a hynny yn fformat XML a JSON. Mae hwn yn wasanaeth rhad ac am ddim ac nid oes angen cofrestru i'w ddefnyddio. Mae telerau ac amodau yn berthnasol (gweler y ddolen isod), ac mae canllawiau ar gael i ddatblygwyr.

Telerau ac amodau

Darllenwch y telerau ac amodau ar gyfer defnyddio'r data a'r delweddau.

Gair am y data hwn

Mae'r data yn darparu'r sgôr hylendid bwyd neu ganlyniad yr arolygiad a roddwyd i'r busnes ac yn adlewyrchu'r safonau hylendid bwyd a welwyd yn ystod yr arolygiad neu'r ymweliad gan yr awdurdod lleol. Mae'r busnesau hyn yn cynnwys bwytai, tafarndai, caffis, siopau tecawê, gwestai a mannau eraill lle mae pobl yn bwyta bwyd, yn ogystal ag archfarchnadoedd a siopau bwyd eraill.

Mae'r data yn cael ei gadw ar ran awdurdodau lleol sy'n cymryd rhan yn un o ddau gynllun hylendid bwyd yr Asiantaeth Safonau Bwyd:

  • Cynllun Sgorio Hylendid Bwyd (CSHB) yng Nghymru, Lloegr a Gogledd Iwerddon
  • Cynllun Gwybodaeth am Hylendid Bwyd (FHIS) yn yr Alban

Mae data ar gael ar gyfer yr awdurdodau lleol sy'n cynnal y cynlluniau hyn yn unig. Gweler rhestr o'r awdurdodau lleol sy'n cynnal y CSHB neu'r FHIS

Statws system

Mae diweddariadau ar statws, cyngor ar ddefnydd ac amryw ddarnau eraill o wybodaeth gyfredol i'w gweld ar Dudalen Statws y System.

Canllawiau API i ddatblygwyr

Mae'r API yn caniatáu i ddatblygwyr gael mynediad at y data ar y sgoriau hylendid bwyd a gyhoeddir ar www.food.gov.uk/ratings. Gall datblygwyr ymholi ffeiliau XML er mwyn cael y data wedi'i geocodio (darperir data hydred a lledred ar gyfer busnesau bwyd). Caiff y data XML ei ddiweddaru'n ddyddiol a gellir ei weld isod, wedi'i grwpio yn ôl awdurdod lleol. Gall y data ar gyfer awdurdodau lleol Cymru gael ei allbynnu yn Gymraeg neu'n Saesneg.

Gellir defnyddio'r API hefyd i ymholi'r system fyw (caiff y data ei lanlwytho'n awtomatig wrth i awdurdodau lleol lanlwytho a chyhoeddi'r data) a'i ddychwelyd ar fformat XML a JSON.

Gellir gweld enghreifftiau o sut i ddefnyddio'r API a chael gwybodaeth am ddefnyddio'r API yn y ddogfen ganllaw ar gyfer datblygwyr:

Delweddau

Mae cyfres o ddelweddau sgorio hylendid bwyd ar gael i'w defnyddio gyda'r data API. Gellir defnyddio'r delweddau yn unol â thelerau ac amodau a Safon Brand y CSHB a'r FHIS yn unig.

Dyma enghreifftiau o'r delweddau a'r meintiau sydd ar gael i'w defnyddio gyda'r data API:

Lawrlwytho bathodynnau newydd y CSHB (cydraniad uchel/high resolution) (ZIP - 1 MB)

Hen luniau ar-lein y cynllun sgorio

Mae fersiwn flaenorol y sgoriau ar-lein bellach wedi dod i ben. Defnyddiwch y delweddau a ddarperir uchod.

Disgrifyddion sgôr

Lawrlwytho data o dudalen canlyniadau chwilio'r Cynllun Sgorio Hylendid Bwyd

Pan fyddwch yn chwilio am sgoriau hylendid ar www.food.gov.uk/sgoriau, gallwch lawrlwytho'r canlyniadau chwilio ar waelod y dudalen.

Nifer y canlyniadau

Gallwch lawrlwytho hyd at 5,000 o ganlyniadau trwy nodi rhif rhwng 1 a 5,000 yn y maes 'Nifer o ganlyniadau'.

Os oes angen i chi lawrlwytho mwy na 5,000 o ganlyniadau er enghraifft, yn y maes 'Nifer o ganlyniadau' nodwch 5,000, yna rhowch bob 'Rhif tudalen', 1, 2 ac ati, nes eich bod wedi lawrlwytho'r holl ganlyniadau.

Fformat y data

Gellir lawrlwytho data mewn fformat XML a JSON.

I drosi'r data yn fformat Excel, defnyddiwch y canllawiau canlynol:
Tudalen gymorth Microsoft: Agorwch ffeil ddata XML er mwyn mewnforio ei ddata i Excel

I gyfuno sawl ffeil Excel yn un ffeil, defnyddiwch y canllawiau canlynol:
Tudalen gymorth Microsoft: Mewnforio data o ffolder gyda sawl ffeil

Ffeiliau data XML y gellir eu lawrlwytho (wedi'u diweddaru'n ddyddiol)

Gellir lawrlwytho data'r sgoriau hylendid bwyd, wedi'u grwpio yn ôl awdurdodau lleol, yn fformat XML drwy'r dolenni isod. Caiff y data ei ddiweddaru'n ddyddiol, ac mae modd ei ymholi drwy'r API.