daimon3332/address

어떤 프로젝트인가요?

핵심 기능

• 0127개 국가와 지역을 지원하며, 국가별 행정 구역 체계에 맞춘 필터를 제공합니다.
• 02각 주소에 출처, 일치 정밀도, 좌표가 포함됩니다.
• 03여러 중국어, 일본어, 한국어 및 유럽어를 포함한 10개 표시 언어로 출력할 수 있습니다.
• 04재시도 횟수 제한 및 데이터 소진 감지를 지원하는 점진적 백그라운드 동기화 기능을 제공합니다.
• 05단건 및 일괄 생성, 위치 검색, 번역을 지원하는 Bearer 인증 API를 제공합니다.
• 06처음 시작할 때 자체적으로 시크릿을 생성하는 단일 Docker Compose 배포 방식을 지원합니다.

활용 사례

• 체크아웃 및 회원 가입 양식의 테스트 데이터를 채우는 데 사용합니다.
• 여러 국가의 주소 형식을 검증하는 데 사용합니다.
• 물류 또는 지도 데모용으로 실제 같은 주소를 만드는 데 사용합니다.
• 테스트 파이프라인에서 API를 통해 주소를 일괄 생성하는 데 사용합니다.

빠른 시작

1. 1

   Docker Compose 파일 다운로드

   curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml
2. 2

   모든 서비스 시작

   docker compose up -d
3. 3

   준비 상태 확인

   curl -fsS http://127.0.0.1:8787/api/v1/ready

사용 전 알아둘 점

• !Docker Engine 24 이상 및 Compose v2가 설치된 Linux(AMD64 또는 ARM64)가 필요합니다.
• !최소 4 GB RAM이 필요하며, 대규모 국가 데이터를 처음 가져올 때는 8 GB 이상을 권장합니다.
• !업스트림 데이터셋에는 각 데이터셋의 라이선스와 저작자 표시 요건이 적용됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

address은(는) 무엇인가요?

27개 국가와 지역의 공식 주소 등록부 및 공개 지도 데이터를 바탕으로 실제 주소를 반환하는 셀프 호스팅 주소 생성기입니다. Address는 무작위로 조합한 문자열이 아니라 실제 장소에 해당하는 주소를 테스트와 데모용으로 생성합니다. 각 레코드는 공식 주소 등록부, 공개 지도 데이터 또는 검증된 지오코딩 결과에서 가져오며, 출처와 정밀도, 좌표를 포함합니다. 데이터가 없는 필드는 다른 값으로 채우지 않고 비워 둡니다.

address은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

address은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

address은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. address의 마지막 커밋은 2026년 11월 4일입니다.

address은(는) 어디에 사용할 수 있나요?

체크아웃 및 회원 가입 양식의 테스트 데이터를 채우는 데 사용합니다. 여러 국가의 주소 형식을 검증하는 데 사용합니다. 물류 또는 지도 데모용으로 실제 같은 주소를 만드는 데 사용합니다. 테스트 파이프라인에서 API를 통해 주소를 일괄 생성하는 데 사용합니다.

address는 어떻게 설치하나요?

Docker Compose 파일 다운로드: curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml 모든 서비스 시작: docker compose up -d 준비 상태 확인: curl -fsS http://127.0.0.1:8787/api/v1/ready

address은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/daimon3332/address