Hvordan du bruger Sitata API'en til at bestemme de begrænsninger for rejsende, der gælder for rejsende

Skrevet af Madeline Sharpe

22. december 2020

Teknologi

Mange af jer ved det måske ikke, men de første grundlæggelser af Sitata er blevet bygget for at forebygge sygdomme. En fait, notre fondatrice a organisé un discours TedX à partir de 2016 sur les grunde for hvilke vi bør advare rejsende for at forebygge udbredelsen af sygdomme. Il n'est donc pas overraskende que nous ayons appris l'existence du COVID-19, qui a été signalé comme un groupe inhabituel de cas de pneumonie au début du mois de décembre 2019. Le 2 janvier 2020, notre équipe de santé a décidé que nous devions émettre un premier avertissement à nos voyageurs et partenaires commerciaux. C'était quelques jours avant même l'Organisation mondiale de la santé !

Lors des inévitables retombées, nous avons eu une révélation. Sygdommen spredte sig så hurtigt, at det var klart for os, at den globale reaktion ville være mere kaotisk. Hvert land skulle udstede sine egne regler og bestemmelser for at kontrollere spredningen. Dette ville uvægerligt gøre ravage i hele verden og være en enorm kilde til forvirring for dem, der ønskede at rejse endnu mere. Nous avions raison et nous avons décidé de faire quelque chose pour y remédier. Sitata a été l'une des premières entreprises au monde à créer une API dédiée et un service de suivi des changes apportés aux restrictions de voyage et aux conditions d'entrée suite à COVID-19. Takket være et avanceret system til registrering af begivenheder og et specialiseret analytikerhold råder vi allerede over alle de nødvendige værktøjer og processer til at nå frem.

Siden lanceringen af denne nye tjeneste har flere organisationer, bl.a. Eddy Travels, Flight Centre og Etihad Airways, udnyttet dataene til fordel for deres egne kunder; andre oplysninger vil snart blive annonceret! For at hjælpe et stort antal organisationer med fokus på rejser med at drage fordel af dette tilbud har vi nedenfor en række eksempler for at forklare hvordan API'et kan bruges i forskellige tilfælde af anvendelse. Jeg håber, at disse forklaringer vil hjælpe Dem med at iværksætte Deres egne initiativer.

Betingelser for adgang

De første spørgsmål, som en rejsende stiller, er uden tvivl: "Puis-je y aller ?" og "Serai-je mis en quarantaine", det er derfor et godt udgangspunkt. Nous avons créé l'ensemble de données sur les conditions d'entrée pour svara aux questions difficiles du type "oui/non" concernant l'entrée dans un pays ou une région.

På tidspunktet for udarbejdelsen af dette dokument omfattede denne samling af data de følgende ti kategorier:

  • Un résident peut-il entrer dans le pays ?
  • Un étranger peut-il entrer dans le pays ?
  • Er transit tilladt på tværs af landet?
  • Er en test påkrævet ved ankomsten (apparition d'une maladie) ?
  • Er en testattest godkendt (forekomst af en sygdom) ?
  • Une quarantaine est-elle nécessaire à l'arrivée (apparition d'une maladie) ? Une vaccination est-elle nécessaire ?
  • Assurance requise ?
  • Certificat de test kræves ?
  • Formulaire d'inscription requis ? (sundhed eller andet)

Hver kategori kan have en af følgende værdier :

  • Oui
  • Oui, med nogle undtagelser
  • Ikke
  • Non, undtagen undtagelser

Hvis størstedelen af værdierne er "ja" og "nej", er situationen på terrænet ikke altid lige så enkel. Parfois, il existe des règles vraiment bizarres et folles que divers gouvernements ont mises en place et qui nécessitées les types de valeurs "avec exceptions"

En indrejsebetingelse er hovedsagelig et dokument, der indeholder en række regler, som en aktør pålægger en aktør over for et eller flere andre lande eller regioner. L'aktøren kan være et land, en stat eller en kommune i vores arkitektur af data. I det hele taget dækker Sitata i øjeblikket data på landeniveau. Toutefois, nous disposons de quelques enregistrements d'états/provinces pour certaines régions, comme les États-Unis et d'autres

Enhver optagelse med en indgang under feltet origine_pays_division_id ou origine_pays_région_id est un niveau qui se situe respectivement au niveau de l'État ou au niveau municipal. Hvis De ønsker at råde over mere omfattende data, bedes De kontakte os et nous pourrons discuter de votre cas d'utilisation.

Du bør tage dig tid til at gøre dig bekendt med strukturen af oplysningerne om adgangsbetingelserne for konsulenter vores dokumenter API ici.

Une partie de la structure des données est légèrement déroutante, à savoir notre usage du terme"origine" Denne forvirring skyldes, at udviklerne ofte betragter oprindelsen som værende oprindelsessted eller afgangssted. Or, ce que nous entendons par "origine" est en fait l'origine de la règle imposée à d'autres, c'est-à-dire le pays ou la région qui a créé la restriction.

Et andet vigtigt punkt at bemærke er, hvordan vores liste over berørte lande fungerer. Hvis affected_countries er tomt, skal det fortolkes som en global regel, dvs. at alle lande er berørt.

Nogle eksempler

Som du har kunnet se i dokumentationen, findes der flere måder at hente API-data på. Ci-dessous, nous allons passere en revue quelques-uns des cas d'usage les plus courants.

Comment obtenir les exigences entre deux pays ?

Der findes flere måder at gøre denne type anmodning på. Den mest enkle version består i at anvende den destination og afgang parametre. Disse parametre accepterer koderne ISO 3166-1 alpha-2 som indgange

GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=IN

Svaret vil omfatte alle de krav (på lande- og statsniveau), der er nødvendige for at forstå for den rejsende, der rejser fra afrejselandet og til bestemmelseslandet.

Et si je veux des données au niveau de l'État ?

Sitata råder over data på statsligt niveau for visse regioner. Vous saurez qu'une entrée particulière est pour un État si le origine_pays_division a une valeur. Vous pouvez également filtrere for ikke at gendanne dataene på niveau af tilstand ved at bruge champ destination_pays_division paramètre. Il attend une valeur ISO_3166-2. For eksempel US-TX for Texas, États-Unis.

GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-AP

Bemærk, at det kunne være mere enkelt at foretage en søgning pr. land og derefter filtrere dataene pr. stat for at se, om de findes, og for at bruge dem, hvis de findes.

Comment puis-je obtenir les exigences entre deux aéroports ?

Ligesom for de andre lande kan API Sitata også sende resultaterne tilbage til de to lufthavne. De parametre départ_aéroport og destination_aéroport bruge koderne i l'OACI ou de l'IATA pour filtrer les résultats. La réponse comprendra toutes les restrictions (au niveau du pays et de l'État) nécessaires à la compréhension du voyageur partant du pays de départ correspondant et se rendant dans le pays de destination.

GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOM

Svaret omfatter alle de begrænsninger (på lands- og statsniveau), der er nødvendige at forstå for den rejsende, der rejser fra afgangs- og bestemmelseslandet.

Et si je n'ai que des informations sur la ville ?

Sitata har valgt ikke at svare på anmodninger om et bestemt bynavn, da dette kunne medføre konflikter og forvirring. I stedet for dette har vi valgt at acceptere forespørgsler fra vores API via koordinater for bredde- og længdegrader, hvilket ikke skaber nogen tvetydighed i vores samlede resultater. Parametrene er de følgende départ_lat, departure_lng, destination_latog destination_lng.

GET https://www.sitata.com/api/v2/entry_requirements?departure_lat=48.13743&departure_lng=11.57549&destination_lat=19.0760&destination_lng=72.8777

Hvis du løser dine byer i henhold til steder og anmodninger i henhold til koordinater, svarer vores API med alle de begrænsninger (på lands- og statsniveau), der er nødvendige for forståelsen af den rejsende, der rejser fra afgangs- og bestemmelseslandet.

Yderligere oplysninger

For visse typer af indgangsbetingelser kan der være tale om supplerende data, der er tilknyttet en kategori af typer af metadonerne, der kaldes ekstraudstyr. Dette felt er en kortlægning af de forskellige supplerende oplysninger for en særlig behovssituation

Quel est le nombre de jours de quarantaine ?

Denne dataindsamling er underlagt oplysningspligten type 5. I denne indgang, le ekstraudstyr la cartographie contiendra un champ appelé quarantaine_days som indeholder et samlet antal for det antal dage, der er pålagt kvartalsvis.

Quel est le nombre d'heures avant l'entrée pour un test covid négatif ?

Denne dataindsamling er underlagt oplysningspligten type 8. I denne indgang, le ekstraudstyr la cartographie contiendra un champ appelé entry_hours qui contiendra un nombre entier pour le nombre d'heures pendant lesquelles un test covid négatif est autorisé avant l'entrée.

Faites-nous savoir

Vi mener, at vi råder over et meget robust værktøj, der sandsynligvis opfylder alle dine behov for at hjælpe dine rejsende med at forstå, hvad de kan møde undervejs. Hvis De har et særligt tilfælde af anvendelse, som vi ikke behandler, så gør det til os savoir !

Attendez... il y a a plus !

Denne indgang er en del af en række af to parter, der forklarer hvordan du kan interagere med API Sitata for at få oplysninger om indgangsbetingelser og rejserestriktioner. Indtil nu har vi talt om indrejsebetingelser, der beskriver de strenge betingelser af typen ja/nej, der er nødvendige for at komme ind i et land eller en region, men vi har ikke talt om det, der gælder inden for landet. C'est une chose de savoir comment entrer dans un pays, c'en est une autre de comprendre s'il est possible de se déplacer dans le pays ou de visiter les plages ou s'il y a un couvre-feu obligatoire.

Restez à l'écoute pour le deuxième article qui approfondira notre série de données sur les restrictions de voyage. Astuce : il est presque identique, vous pouvez donc toujours consulter notre dokumentation om API'en en ledsager.

Følg og synes godt om os:

Relaterede artikler

From Metro to Marathon: Transportation Tips for The Paris Olympics

From Metro to Marathon: Transportation Tips for The Paris Olympics

Millions of people are expected to visit Paris for the 2024 Summer Olympic and Paralympic Games from 26 July to 11 August and 28 August to 8 September. Are you also gearing up to witness the games this year and looking for a perfect travel guide? Consider it done,...

Højpatogen fugleinfluenza - H5N1

Højpatogen fugleinfluenza - H5N1

Der findes en stamme af influenzavirus kaldet H5N1, som er meget dødelig for vilde fugle og tamfjerkræ (kyllinger, ænder osv.). Den har forårsaget store udbrud i tamme hønseflokke i de seneste årtier. I sjældne tilfælde har denne virus inficeret mennesker, der...