Rhaglen API cynllun sgorio bwyd y DU

Mae'r data yn rhoi'r sgôr hylendid bwyd neu'r canlyniad arolygu a roddir i fusnes ac yn adlewyrchu'r safonau hylendid bwyd a ganfyddir ar ddyddiad yr arolygiad neu'r ymweliad gan yr awdurdod lleol. Mae busnesau'n cynnwys bwytai, tafarndai, caffis, siopau tecawê, gwestai a mannau eraill y mae defnyddwyr yn bwyta ynddynt, yn ogystal ag archfarchnadoedd a siopau bwyd eraill.

Cedwir y data ar ran awdurdodau lleol sy'n cymryd rhan yn y canlynol:

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

Gellir dod o hyd i ddata ar gyfer awdurdodau lleol sy'n cymryd rhan yn naill neu'r llall o'r cynlluniau hyn ar y wefan sgoriau: Gweler rhestr o awdurdodau lleol sy'n cymryd rhan yn y CSHB neu'r FHIS

Mae'r sgoriau yn y data yn berthnasol i'r CSHB yn unig (nid FHIS) ac maent ar gyfer hylendid, strwythur a hyder yn y trefniadau rheoli. Mae'r sgoriau hyn i'w gweld yn rhan 2 a 3 o Atodiad 1, A1.1 o'r Cod Ymarfer Cyfraith Bwyd. Yna, defnyddir y sgoriau hyn i gyfrifo'r sgôr hylendid bwyd, a cheir manylion y sgôr yn y Canllawiau ar weithredu'r Cynllun Sgorio Hylendid Bwyd. Pan fydd awdurdod lleol yn ailsgorio busnes ac yn uwchlwytho sgôr newydd ar ei gyfer, ni fydd y sgoriau hylendid, strwythur a hyder yn y trefniadau rheoli ar gael yn y data.

Pan fydd sefydliad yn gweithredu o gyfeiriad preifat, mae'n bosib na fydd y cyfeiriad a'r data geogodio ar gael.

Yr awdurdod lleol sy'n darparu'r LocalAuthorityBusinessID ac mae'n unigryw ar gyfer data'r awdurdod lleol penodol hwnnw, ond gallai awdurdodau lleol eraill ei ddefnyddio hefyd. Mae'r FHRSID yn cael ei gynhyrchu'n awtomatig gan systemau ac mae'n unigryw yn y data. Mae'n seiliedig ar y LocalAuthorityBusinessID a'r LocalAuthorityCode.

Pan fydd awdurdod lleol yn uwchlwytho LocalAuthorityBusinessID newydd i'r system, bydd FHRSID newydd yn cael ei gynhyrchu. Os caiff LocalAuthorityBusinessID ei ailddefnyddio, er enghraifft ar gyfer cofrestriad newydd, bydd yr FHRSID yn cael ei gadw ar gyfer y sefydliad. Sylwch fod rhai awdurdodau lleol yn defnyddio eu cronfa ddata fel cronfa ddata busnesau, ond bod eraill yn defnyddio cronfa ddata sefydliad, felly bydd rhai awdurdodau lleol yn ailgylchu'r LocalAuthorityBusinessID, ond bydd eraill na fyddant yn gwneud hynny.

Mae amgylchiadau lle gallai'r LocalAuthorityBusinessID a'r FHRSID newid, fel pan fydd awdurdodau lleol yn newid cronfeydd data neu lle bydd awdurdodau lleol yn uno. Mae manylion am achosion lle mae hyn wedi digwydd ar gael ar dudalen statws y CSHB. Gellir dod o hyd i wybodaeth ddefnyddiol arall ar y dudalen hon, fel mathau data ar gyfer meysydd.

Gellir dod o hyd i'r mathau o fusnesau a'r IDs cysylltiedig yn: api1-ratings.food.gov.uk/business-types/xml

Pan welir 'I'w gyhoeddi'n fuan' yn lle sgôr, y rheswm dros hyn yw'r ffaith bod y busnes wedi apelio yn erbyn ei sgôr a bod yr awdurdod lleol wrthi'n penderfynu ar yr apêl.

Mae NewRatingPending yn cael ei ddangos fel maes gwir yn y data lle mae awdurdod lleol wedi uwchlwytho data newydd ar gyfer sefydliad sydd heb ei gyhoeddi eto, gan fod y data hwn yn y cyfnod hysbysu neu apelio. Bydd yn cael ei gyhoeddi ar ôl i'r cyfnodau amser hyn ddod i ben. Os caiff ei ddangos fel maes ffug, nid oes unrhyw ddata newydd yn y llif gwaith i'w gyhoeddi.

Mae rhagor o wybodaeth am y cynllun ar gael yn: https://www.food.gov.uk/cy/canllawiau-defnyddiwr/cynllun-sgorio-hylendid-bwyd

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

Mae'r API yn caniatáu i ddatblygwyr gael mynediad at y data ar y sgoriau hylendid bwyd a gyhoeddir ar ratings.food.gov.uk. 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:

• Darllen y canllawiau API V1 i ddatblygwyr (pdf 316KB, diweddarwyd ym mis Ebrill 2024)
• Darllen y canllawiau API V2 i ddatblygwyr

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

• Cymraeg
• Saesneg

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 ar ffurf XML a JSON ar gyfer ffeiliau'r awdurdod lleol, ac mae data ar gael ar fformat CSV ar gyfer y ffeil sy'n cynnwys holl ddata'r awdurdod lleol.

I drosi'r data fel ei fod ar ffurf Excel, defnyddiwch y canllawiau canlynol:
Tudalen gymorth Microsoft: Agor ffeil ddata XML i fewnforio ei ddata i Excel(Yn agor mewn tab newydd)

I gyfuno sawl ffeil Excel yn un ffeil, defnyddiwch y canllawiau canlynol:
Tudalen gymorth Microsoft: Mewnforio data o ffolder sydd â sawl ffeil(Yn agor mewn tab newydd)

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.