Dostawy, przedstawiciele, serwis w terenie, mapy i CRM

Współrzędne z adresu i adres ze współrzędnych

Dane z państwowego rejestru adresowego (punkty adresowe PRG, GUGiK), a nie z płatnego geokodera. Dla polskich adresów to najdokładniejsze źródło, bo z tego rejestru adresy pochodzą. Samo zapytanie do rejestru potrafi jednak zmylić, więc API robi za Ciebie resztę:

• pisownia miejscowości: „Krakow” bez polskich znaków rejestr pomija całkowicie, API odtwarza „Kraków” (po kodzie pocztowym, gdy nazwa jest niejednoznaczna),
• numer z dopiskiem: „94/98 lok. 2” albo „42lok.U2” rejestr odrzuca, API upraszcza numer krok po kroku,
• kontrola ulicy: na nieznaną ulicę rejestr odpowiada najbliższą podobną („Polwiejska 2” → Podmiejska 2); API porównuje nazwy i takiej odpowiedzi nie przyjmuje,
• poziom trafienia: adres, ulica albo miejscowość, zawsze podany w odpowiedzi razem z uwagami,
• właściwa miejscowość z wielu: Psary są w Polsce 21 razy; wybiera kod pocztowy albo jego gmina, a bez kodu miasto na prawach powiatu.

Adres ze współrzędnych liczy się tak samo jak współrzędne z adresu: jedna pozycja = jeden adres z limitu. Jednorazowe uzupełnienie współrzędnych w całym pliku klientów zrobimy też w ramach porządku w danych.

Współrzędne z adresu

curl https://odswiezona.pl/api/v1/wspolrzedne \
  -H "Authorization: Bearer odsw_TWÓJ_KLUCZ" \
  -H "Content-Type: application/json" \
  -d '{"adresy": ["ul. Marszałkowska 94/98 lok. 2, 00-510 Warszawa",
               {"miejscowosc": "Krakow", "ulica": "Dluga", "numer": "1"}]}'

{
  "ok": true,
  "wyniki": [
    { "ok": true, "lat": 52.2292521, "lon": 21.0126736, "poziom": "adres",
      "potwierdzone": true, "potwierdzone_przez": "kod_pocztowy",
      "adres": { "miejscowosc": "Warszawa", "ulica": "ulica Marszałkowska", "numer": "94/98", "kod": "00-510",
                 "wojewodztwo": "mazowieckie", "powiat": "Warszawa", "gmina": "Warszawa",
                 "teryt": "146501", "simc": "0918123", "ulic": "12400" },
      "zapytanie": "Warszawa, Marszałkowska 94/98", "uwagi": [] },
    { "ok": true, "lat": 50.0666318, "lon": 19.9391034, "poziom": "adres", "potwierdzone": true,
      "adres": { "miejscowosc": "Kraków", "ulica": "ulica Długa", "numer": "1", "kod": "31-147", … },
      "uwagi": ["Uzupełniono pisownię miejscowości: Krakow → Kraków (…)"] }
  ],
  "zrodlo": "punkty adresowe PRG (GUGiK); pisownia miejscowości: GeoNames (CC-BY 4.0)",
  "limit": { "dzienny": 1000, "wykorzystano": 2 }
}

Adres ze współrzędnych

curl https://odswiezona.pl/api/v1/adres \
  -H "Authorization: Bearer odsw_TWÓJ_KLUCZ" \
  -H "Content-Type: application/json" \
  -d '{"punkty": [{"lat": 52.2297, "lon": 21.0122}], "promien": 100}'

{ "ok": true, "promien": 100,
  "wyniki": [{ "ok": true, "odleglosc_m": 59,
    "adres": { "miejscowosc": "Warszawa", "ulica": "ulica Marszałkowska", "numer": "94/98", "kod": "00-510", … } }],
  "limit": { "dzienny": 1000, "wykorzystano": 3 } }

Co	Jak
Adres	POST /api/v1/wspolrzedne: adres albo adresy (do 10 w jednym zapytaniu); pozycja to tekst z przecinkiem („ulica numer, kod miejscowość”) albo obiekt { miejscowosc, ulica, numer, kod }. Kod pocztowy nie jest wymagany, ale pomaga przy powtarzających się nazwach
Punkt	POST /api/v1/adres: lat i lon (WGS84) albo punkty (do 10), promien od 1 do 2000 m (domyślnie 100)
Poziom	adres (punkt budynku), ulica (środek ulicy, gdy rejestr nie zna numeru), miejscowosc (środek miejscowości); potwierdzone: czy miejscowość wskazał kod pocztowy, jego gmina, jedyne dopasowanie albo miasto na prawach powiatu
Identyfikatory	teryt, simc i ulic z rejestrów TERYT, gdy rejestr je podaje; województwo, powiat i gmina
Klucz i limity	nagłówek Authorization: Bearer odsw_…; dzienny limit adresów według planu i 20 zapytań na minutę
Błędy	400 złe dane (nie liczą się do limitu), 401 zły klucz, 429 limit; adres nieznany rejestrowi albo chwilowa awaria rejestru to "ok": false w danej pozycji ("ponow": true, gdy warto wysłać ją jeszcze raz)

Dane pochodzą z usługi GUGiK dostępnej publicznie; rejestr może mieć przerwy, na które nie mamy wpływu. Adresów i współrzędnych nie zapisujemy, liczymy tylko liczbę pozycji na klucz. Do rejestru trafia sam adres albo punkt, bez niczego więcej. Jeśli adresy dotyczą osób (np. Twoich klientów), przetwarzamy je na Twoje zlecenie na podstawie umowy powierzenia, którą podpisujemy razem z umową na API. Pisownię miejscowości odtwarzamy ze zbioru GeoNames (geonames.org, licencja CC-BY 4.0).

Klucz testowy na tydzień

Napisz, do czego chcesz używać współrzędnych. Dostaniesz klucz z małym limitem, żeby sprawdzić trafność na własnych adresach.

Poproś o klucz testowy