Set di dati con l'albero geografico.
Capitoli:
Consente di effettuare interrogazioni utilizzando i codici paese ISO (2 cifre), o i codici regione ISO-3166-2. Emette l'albero geografico.
Per recuperare i dati, utilizzare il seguente URL. Si prega di prestare attenzione alle maiuscole e alle minuscole.
Con le seguenti variabili è possibile completare la query e controllare i risultati delle API.
| Parametro | Spiegazione | Esempi |
|---|---|---|
| api_key richiesto |
La vostra chiave API |
?api_key=abc-123-def-456 |
| ISO richiesto |
Codice ISO del paese, 2 cifre, o Codice regione secondo ISO 3166-2 |
&ISO=DE-BW |
| cities | Flag per l'esportazione estesa con le città registrate: Varianti: |
&cities=1 |
| charset | La codifica desiderata della risposta Varianti: |
&charset=iso-8859-1 |
| format | Il formato di uscita desiderato Varianti: |
&format=xml |
| hl | Lingua desiderata dell'uscita Varianti: |
&hl=en |
Il contenuto delle risposte API deriva da:
- i dati che hai sottoscritto (paesi, vacanze, vacanze scolastiche, anni solari)
- i dati ufficialmente noti dei legislatori
- la disponibilità in base alle nostre ricerche (situazione effettiva del nostro database)
Si prega di notare che l'output in formato CSV è diverso.
| Array | Spiegazione | Esempio | ||||
|---|---|---|---|---|---|---|
| interface | Versione dell'API | |||||
| source: | href | URL della fonte dei dati (sito web) | ||||
| description | Nome della fonte dei dati | |||||
| copyright | href | URL al titolare del copyright (sito web) | ||||
| description | Designazione del titolare del diritto d'autore | |||||
| apiName | Identificazione dell'API | GeoTree/ISO | ||||
| apiStatus | description | Designazione dello stato API. Per le varianti, vedere i Messaggi di errore | active | |||
| date | Data di esportazione dei dati | 04.05.2024 | ||||
| request: | iso | Codice ISO del paese, 2 cifre | BE | |||
| charset | Codifica dei caratteri di output | utf-8 | ||||
| format | Formato dei dati di uscita | json | ||||
| hl | Lingua di emissione, secondo la richiesta | it | ||||
| results | status | description | Stato dell'output. Per le varianti, vedere i Messaggi di errore | ok | ||
| location | Unità geografica secondo la richiesta | |||||
| description | Nome dell'unità geografica | Belgio | ||||
| type | Designazione del tipo di unità geografica | Paese | ||||
| geoId | Geo-ID dell'unità geografica. | 3285 | ||||
| iso | Codice ISO del paese, 2 cifre | BE | ||||
| iso-3166-2 | Codice regione secondo ISO 3166-2 | |||||
| cities | Tutte le città e i paesi coperti in questa regione | |||||
| description | ||||||
| cityId | ||||||
| children | Eventuali unità geografiche subordinate | |||||
| description | Nome dell'unità geografica | Bruxelles | ||||
| type | Designazione del tipo di unità geografica | Regione | ||||
| geoId | Geo-ID dell'unità geografica. | 3288 | ||||
| iso | Codice ISO del paese, 2 cifre | BE | ||||
| iso-3166-2 | Codice regione secondo ISO 3166-2 | BE-BRU | ||||
| cities | Tutte le città e i paesi coperti in questa regione | |||||
| children | Eventuali unità geografiche subordinate (sono possibili fino a 4 livelli) |
array |
| Posizione di uscita | Messaggio di errore | Spiegazione |
|---|---|---|
| results: status: | ||
| results: status: description | unknown location | Il codice paese ISO richiesto non è noto.
Si prega di controllare il parametro ISO |
| apiStatus | ||
| apiStatus: description | invalid usage | L'uso di questa API non è sbloccato per voi. Si prega di contattare il nostro supporto. |
| apiStatus: description | invalid key | Chiave API non valida. Si prega di controllare la chiave API. |
| apiStatus: description | invalid referer | Accesso non valido. Non sono ammessi link da pagine web (front-end). Impostate la vostra richiesta in modo che provenga da un back-end protetto. Se necessario, contattare il nostro supporto. |
| apiStatus: description | inactive | L'API non è ancora stata abilitata all'uso. Si prega di riprovare in un secondo momento. |
| apiStatus: description | expired | Il periodo di utilizzo secondo il contratto è scaduto. Contattate la nostra amministrazione per un prolungamento del contratto. |
URL:
https://feiertagskalender.ch/api/GeoTree/ISO/?api_key=YOUR_API_KEY&iso=BE&cities=1
Risposta delle API:
{
"interface":"fcal API 2.0",
"source":{
"href":"https://feiertagskalender.ch",
"description":"feiertagskalender.ch"
},
"copyright":{
"href":"https://psc.ch",
"description":"psc Peter Schuetz Informatik-Dienstleistungen, CH Bern"
},
"apiName":"GeoTree/ISO",
"apiStatus":{
"description":"active"
},
"date":"2024-05-04",
"request":{
"iso":"BE",
"charset":"utf-8",
"format":"json",
"hl":"de"
},
"results":{
"status":{
"description":"ok"
},
"location":{
"description":"Belgien",
"type":"Land",
"geoId":"3285",
"iso":"BE",
"iso-3166-2":"",
"cities":null,
"children":[
{
"description":"Bruxelles",
"type":"Region",
"geoId":"3288",
"iso":"BE",
"iso-3166-2":"BE-BRU",
"cities":[
{
"description":"Brussels",
"cityId":"1785"
},
{
"description":"Brussels Airport",
"cityId":"23711"
}
],
"children":null
},
{
"description":"Flandre",
"type":"Region",
"geoId":"3286",
"iso":"BE",
"iso-3166-2":"BE-VLG",
"cities":null,
"children":[
{
"description":"Antwerpen",
"type":"Provinz",
"geoId":"3546",
"iso":"BE",
"iso-3166-2":"BE-VLG",
"cities":[
{
"description":"Antwerp",
"cityId":"2468"
},
{
"description":"Turnhout",
"cityId":"25501"
}
],
"children":null
},
{
"description":"Limburg",
"type":"Provinz",
"geoId":"3548",
"iso":"BE",
"iso-3166-2":"BE-VLG",
"cities":[
{
"description":"Hasselt",
"cityId":"10377"
},
{
"description":"Maasmechelen",
"cityId":"16268"
}
],
"children":null
},
{
"description":"Oost-Vlaanderen",
"type":"Provinz",
"geoId":"3545",
"iso":"BE",
"iso-3166-2":"BE-VLG",
"cities":[
{
"description":"Ghent",
"cityId":"2738"
}
],
"children":null
},
{
"description":"Vlaams-Brabant",
"type":"Provinz",
"geoId":"3547",
"iso":"BE",
"iso-3166-2":"BE-VLG",
"cities":[
{
"description":"Leuven",
"cityId":"3488"
}
],
"children":null
},
{
"description":"West-Vlaanderen",
"type":"Provinz",
"geoId":"3544",
"iso":"BE",
"iso-3166-2":"BE-VLG",
"cities":[
{
"description":"Bruges",
"cityId":"3318"
},
{
"description":"De Panne",
"cityId":"3368"
},
{
"description":"Ostend",
"cityId":"12368"
}
],
"children":null
}
]
},
{
"description":"Wallonnie",
"type":"Region",
"geoId":"3287",
"iso":"BE",
"iso-3166-2":"BE-WAL",
"cities":null,
"children":[
{
"description":"Henegouwen",
"type":"Provinz",
"geoId":"3549",
"iso":"BE",
"iso-3166-2":"BE-WAL",
"cities":[
{
"description":"Charleroi",
"cityId":"3348"
},
{
"description":"Endingen",
"cityId":"366"
},
{
"description":"Mons",
"cityId":"3538"
}
],
"children":null
},
{
"description":"Luik",
"type":"Provinz",
"geoId":"3551",
"iso":"BE",
"iso-3166-2":"BE-WAL",
"cities":[
{
"description":"Ans",
"cityId":"12538"
},
{
"description":"Liège",
"cityId":"1935"
},
{
"description":"Verviers",
"cityId":"11158"
}
],
"children":null
},
{
"description":"Luxemburg",
"type":"Provinz",
"geoId":"3553",
"iso":"BE",
"iso-3166-2":"BE-WAL",
"cities":[
{
"description":"Arlon",
"cityId":"10397"
},
{
"description":"Bastogne",
"cityId":"8608"
},
{
"description":"Liezen",
"cityId":"8618"
}
],
"children":null
},
{
"description":"Namur",
"type":"Provinz",
"geoId":"3552",
"iso":"BE",
"iso-3166-2":"BE-WAL",
"cities":[
{
"description":"Namur",
"cityId":"3558"
}
],
"children":null
},
{
"description":"Waals-Brabant",
"type":"Provinz",
"geoId":"3550",
"iso":"BE",
"iso-3166-2":"BE-WAL",
"cities":[
{
"description":"Ottignies-Louvain-la-Neuve",
"cityId":"16257"
}
],
"children":null
}
]
}
]
}
}
}
URL:
https://feiertagskalender.ch/api/GeoTree/ISO/?api_key=YOUR_API_KEY&iso=BE&cities=1&format=xml
Risposta delle API:
<fcal_api> <interface>fcal API 2.0</interface> <source> <href>https://feiertagskalender.ch</href> <description>feiertagskalender.ch</description> </source> <copyright> <href>https://psc.ch</href> <description>psc Peter Schuetz Informatik-Dienstleistungen, CH Bern</description> </copyright> <apiStatus> <description>active</description> </apiStatus> <apiName>GeoTree/ISO</apiName> <date>2024-05-04</date> <request> <iso>BE</iso> <charset>utf-8</charset> <format>xml</format> <hl>de</hl> </request> <results> <status> <description>ok</description> </status> <location> <description>Belgien</description> <type>Land</type> <geoId>3285</geoId> <iso>BE</iso> <iso-3166-2></iso-3166-2> <cities></cities> <children> <child> <description>Bruxelles</description> <type>Region</type> <geoId>3288</geoId> <iso>BE</iso> <iso-3166-2>BE-BRU</iso-3166-2> <cities> <city> <description>Brussels</description> <cityId>1785</cityId> </city> </cities> <children></children> </child> <child> <description>Flandre</description> <type>Region</type> <geoId>3286</geoId> <iso>BE</iso> <iso-3166-2>BE-VLG</iso-3166-2> <cities></cities> <children> <child> <description>Antwerpen</description> <type>Provinz</type> <geoId>3546</geoId> <iso>BE</iso> <iso-3166-2>BE-VLG</iso-3166-2> <cities> <city> <description>Antwerp</description> <cityId>2468</cityId> </city> </cities> <children></children> </child> <child> <description>Limburg</description> <type>Provinz</type> <geoId>3548</geoId> <iso>BE</iso> <iso-3166-2>BE-VLG</iso-3166-2> <cities> <city> <description>Hasselt</description> <cityId>10377</cityId> </city> <city> <description>Maasmechelen</description> <cityId>16268</cityId> </city> </cities> <children></children> </child> <child> <description>Oost-Vlaanderen</description> <type>Provinz</type> <geoId>3545</geoId> <iso>BE</iso> <iso-3166-2>BE-VLG</iso-3166-2> <cities> <city> <description>Ghent</description> <cityId>2738</cityId> </city> </cities> <children></children> </child> <child> <description>Vlaams-Brabant</description> <type>Provinz</type> <geoId>3547</geoId> <iso>BE</iso> <iso-3166-2>BE-VLG</iso-3166-2> <cities> <city> <description>Leuven</description> <cityId>3488</cityId> </city> </cities> <children></children> </child> <child> <description>West-Vlaanderen</description> <type>Provinz</type> <geoId>3544</geoId> <iso>BE</iso> <iso-3166-2>BE-VLG</iso-3166-2> <cities> <city> <description>Bruges</description> <cityId>3318</cityId> </city> <city> <description>De Panne</description> <cityId>3368</cityId> </city> <city> <description>Ostend</description> <cityId>12368</cityId> </city> </cities> <children></children> </child> </children> </child> <child> <description>Wallonnie</description> <type>Region</type> <geoId>3287</geoId> <iso>BE</iso> <iso-3166-2>BE-WAL</iso-3166-2> <cities></cities> <children> <child> <description>Henegouwen</description> <type>Provinz</type> <geoId>3549</geoId> <iso>BE</iso> <iso-3166-2>BE-WAL</iso-3166-2> <cities> <city> <description>Charleroi</description> <cityId>3348</cityId> </city> <city> <description>Endingen</description> <cityId>366</cityId> </city> <city> <description>Mons</description> <cityId>3538</cityId> </city> </cities> <children></children> </child> <child> <description>Luik</description> <type>Provinz</type> <geoId>3551</geoId> <iso>BE</iso> <iso-3166-2>BE-WAL</iso-3166-2> <cities> <city> <description>Ans</description> <cityId>12538</cityId> </city> <city> <description>Liège</description> <cityId>1935</cityId> </city> <city> <description>Verviers</description> <cityId>11158</cityId> </city> </cities> <children></children> </child> <child> <description>Luxemburg</description> <type>Provinz</type> <geoId>3553</geoId> <iso>BE</iso> <iso-3166-2>BE-WAL</iso-3166-2> <cities> <city> <description>Arlon</description> <cityId>10397</cityId> </city> <city> <description>Bastogne</description> <cityId>8608</cityId> </city> <city> <description>Liezen</description> <cityId>8618</cityId> </city> </cities> <children></children> </child> <child> <description>Namur</description> <type>Provinz</type> <geoId>3552</geoId> <iso>BE</iso> <iso-3166-2>BE-WAL</iso-3166-2> <cities> <city> <description>Namur</description> <cityId>3558</cityId> </city> </cities> <children></children> </child> <child> <description>Waals-Brabant</description> <type>Provinz</type> <geoId>3550</geoId> <iso>BE</iso> <iso-3166-2>BE-WAL</iso-3166-2> <cities> <city> <description>Ottignies-Louvain-la-Neuve</description> <cityId>16257</cityId> </city> </cities> <children></children> </child> </children> </child> </children> </location> </results> </fcal_api>
Aufruf:
https://feiertagskalender.ch/api/GeoTree/ISO/?api_key=YOUR_API_KEY&iso=BE&cities=1&format=csv
Risposta delle API:
"location_L0";"type_L0";"geoId_L0";"iso_L0";"iso-3166-2_L0";"location_L1";"type_L1";"geoId_L1";"iso_L1";"iso-3166-2_L1";"location_L2";"type_L2";"geoId_L2";"location_L3";"type_L3";"geoId_L3";"location_L4";"type_L4";"geoId_L4";"cityName";"cityId"
"Belgien";"Land";"3285";"BE";"";"";"";"";"";"";"";"";"";"";"";"";"";"";"";"";""
"Belgien";"Land";"3285";"BE";"";"Bruxelles";"Region";"3288";"BE";"BE-BRU";"";"";"";"";"";"";"";"";"";"";""
"Belgien";"Land";"3285";"BE";"";"Bruxelles";"Region";"3288";"BE";"BE-BRU";"";"";"";"";"";"";"";"";"";"Brussels";"1785"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"";"";"";"";"";"";"";"";"";"Brussels";"1785"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"Antwerpen";"Provinz";"3546";"";"";"";"";"";"";"";""
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"Antwerpen";"Provinz";"3546";"";"";"";"";"";"";"Antwerp";"2468"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"Limburg";"Provinz";"3548";"";"";"";"";"";"";"Antwerp";"2468"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"Limburg";"Provinz";"3548";"";"";"";"";"";"";"Hasselt";"10377"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"Limburg";"Provinz";"3548";"";"";"";"";"";"";"Maasmechelen";"16268"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"Oost-Vlaanderen";"Provinz";"3545";"";"";"";"";"";"";"Maasmechelen";"16268"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"Oost-Vlaanderen";"Provinz";"3545";"";"";"";"";"";"";"Ghent";"2738"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"Vlaams-Brabant";"Provinz";"3547";"";"";"";"";"";"";"Ghent";"2738"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"Vlaams-Brabant";"Provinz";"3547";"";"";"";"";"";"";"Leuven";"3488"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"West-Vlaanderen";"Provinz";"3544";"";"";"";"";"";"";"Leuven";"3488"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"West-Vlaanderen";"Provinz";"3544";"";"";"";"";"";"";"Bruges";"3318"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"West-Vlaanderen";"Provinz";"3544";"";"";"";"";"";"";"De Panne";"3368"
"Belgien";"Land";"3285";"BE";"";"Flandre";"Region";"3286";"BE";"BE-VLG";"West-Vlaanderen";"Provinz";"3544";"";"";"";"";"";"";"Ostend";"12368"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"West-Vlaanderen";"Provinz";"3544";"";"";"";"";"";"";"Ostend";"12368"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Henegouwen";"Provinz";"3549";"";"";"";"";"";"";"";""
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Henegouwen";"Provinz";"3549";"";"";"";"";"";"";"Charleroi";"3348"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Henegouwen";"Provinz";"3549";"";"";"";"";"";"";"Mons";"3538"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Henegouwen";"Provinz";"3549";"";"";"";"";"";"";"Endingen";"366"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Luik";"Provinz";"3551";"";"";"";"";"";"";"Endingen";"366"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Luik";"Provinz";"3551";"";"";"";"";"";"";"Liège";"1935"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Luik";"Provinz";"3551";"";"";"";"";"";"";"Verviers";"11158"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Luik";"Provinz";"3551";"";"";"";"";"";"";"Ans";"12538"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Luxemburg";"Provinz";"3553";"";"";"";"";"";"";"Ans";"12538"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Luxemburg";"Provinz";"3553";"";"";"";"";"";"";"Bastogne";"8608"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Luxemburg";"Provinz";"3553";"";"";"";"";"";"";"Liezen";"8618"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Luxemburg";"Provinz";"3553";"";"";"";"";"";"";"Arlon";"10397"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Namur";"Provinz";"3552";"";"";"";"";"";"";"Arlon";"10397"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Namur";"Provinz";"3552";"";"";"";"";"";"";"Namur";"3558"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Waals-Brabant";"Provinz";"3550";"";"";"";"";"";"";"Namur";"3558"
"Belgien";"Land";"3285";"BE";"";"Wallonnie";"Region";"3287";"BE";"BE-WAL";"Waals-Brabant";"Provinz";"3550";"";"";"";"";"";"";"Ottignies-Louvain-la-Neuve";"16257"