O tym API
US Census Geocoder to oficjalna usługa geokodowania prowadzona przez U.S. Census Bureau (Biuro Spisu Ludności USA). Zamienia amerykański adres — podany jednoliniowo lub rozbity na pola — albo współrzędne na dopasowany, znormalizowany adres, współrzędne geograficzne oraz identyfikatory geografii spisowej: stan, hrabstwo, tract i block Census, w oparciu o warstwy TIGER/Line. Endpoint locations zwraca samo dopasowanie i współrzędne, a endpoint geographies dodatkowo przypisuje adres do jednostek spisowych. Usługa obsługuje zapytania pojedyncze oraz tryb wsadowy dla wielu adresów naraz. Każde zapytanie wymaga parametru benchmark (np. Public_AR_Current), a przy zwracaniu geografii także parametru vintage. To geokoder, a nie API statystyczne — same dane demograficzne i gospodarcze udostępnia osobne API U.S. Census Bureau.
Najczęstsze pytania
Czy trzeba mieć klucz API?
Nie — geokoder jest publiczny i darmowy. Zapytania pojedyncze i wsadowe nie wymagają rejestracji ani klucza API. Klucz oferowany w serwisie deweloperskim Census dotyczy osobnego API statystycznego, a nie geokodera.
Jakie dane zwraca to API?
Dla amerykańskiego adresu (lub współrzędnych) zwraca dopasowany, znormalizowany adres, współrzędne geograficzne oraz — przez endpoint geographies — identyfikatory geografii spisowej: stan, hrabstwo, tract i block, na bazie warstw TIGER/Line, w formacie JSON.
Czy można wywołać to API bezpośrednio z przeglądarki?
Nie — usługa nie zwraca nagłówka Access-Control-Allow-Origin, więc przeglądarka blokuje wywołania z innej domeny. Trzeba ją wołać po stronie serwera i dlatego nie ma tu żywego przycisku „Wypróbuj”.
Kto prowadzi to API?
U.S. Census Bureau (Biuro Spisu Ludności USA), agencja Departamentu Handlu USA. Dokumentacja: census.gov.