# Véto Garde: world base of veterinarians (2026-10-21.0)

The veterinarians of the whole world, one row per clinic, as the Véto Garde app uses them: name, phone numbers,
website, email, address, opening hours, emergency service and open 24/7 flags, time zone. Built on 2026-11-15T22:45:06Z by
`build_vets.py` (this folder) from three open sources. It contains information from OpenStreetMap, which is made
available here under the Open Database License (ODbL 1.0): this whole base is published under the same licence,
https://opendatacommons.org/licenses/odbl/1-0/.

## Sources and their licences

- **Overture Maps Foundation**, places theme release `2026-10-21.0` (https://docs.overturemaps.org/attribution/):
  CDLA-Permissive-2.0 (Meta, Microsoft, BrightQuery, Uberall, PinMeTo, DAC and others), Apache-2.0 (Foursquare:
  "Copyright 2024 Foursquare Labs, Inc. All rights reserved", data transformed to the Overture schema),
  CC0-1.0 (All the Places).
- **OpenStreetMap**, `amenity=veterinary` read through the Overpass API (37 slices) and QLever's OpenStreetMap planet for the 38 slices Overpass could not serve (extract of 2026-09-21):
  © OpenStreetMap contributors, ODbL 1.0, https://www.openstreetmap.org/copyright.
- **All the Places**, run `2026-10-31-13-32-34` (https://www.alltheplaces.xyz/): CC0-1.0.

## File

`vets-2026-10-21.0.json.gz`: `{licence, attribution, columns, rows}`, 208687 rows. Columns:

| column | content |
|---|---|
| id | `o:<Overture id>`, `osm:n<id>` / `osm:w<id>` / `osm:r<id>`, or `atp:<spider>:<ref>` |
| lat, lng | WGS 84, 6 decimals |
| name | the clinic's name |
| phones | international format, 3 at most (`[]` when none) |
| website, email | as the sources give them |
| address, city, postcode | street line, city, postcode |
| country, region | ISO 3166-1 alpha-2; region as the source gives it |
| hours | 7 days, Monday first: `null` unknown, `[]` closed, else `[open, close)` intervals in minutes after midnight (close ≤ 1440); `null` when unknown |
| hoursText | the source's `opening_hours` when it could not be read |
| flags | 1 open 24/7, 2 emergency service |
| src | 1 Overture, 2 OpenStreetMap, 4 All the Places (sum) |
| osm | the OpenStreetMap element (`node/123`, `way/123`, `relation/123`) or `null` |
| tz | IANA time zone |

## How it was made

1. Overture: places under taxonomy `veterinary_care` (without pet hospices, holistic care, animal physical therapy),
   not permanently closed, confidence ≥ 0.6, or ≥ 0.5 with a phone number; head offices, associations, insurers and
   stand-alone vet pharmacies or labs left out. Duplicates merged: ≤ 25 m, ≤ 60 m with alike names, the same phone
   ≤ 500 m; the most reliable row is kept and takes what it lacked.
2. All the Places: the vet chains' spiders (opening hours; BluePearl's hospitals flagged as emergency services),
   matched to a row by phone (≤ 1 km), website (≤ 300 m) or alike names (≤ 100 m, any name ≤ 25 m), else added.
3. OpenStreetMap: matched the same way; they bring opening hours (when All the Places has none), `emergency=yes`,
   24/7 and the OSM reference; the others are added.
4. Countries from the sources (else the nearest Overture vet), phones in international format (libphonenumber),
   time zones (timezonefinder), opening hours read from the OSM syntax, emergency flags from the categories, OSM
   tags, the hours (open every day around the clock) and the names in some forty languages.

`build_vets.py` reproduces it: `python3 build_vets.py --release 2026-10-21.0 --out <dir>`.
