📝 한줄 요약
설정 화면에서 사무실 주소로 시간대를 알아내야 했는데, Free Timezone API가 6개나 있었어요. “가장 좋은” 게 아니라 “내가 붙이기 쉬운” 것을 기준으로 선택했습니다.
👥 이런 분께 추천
웹앱을 만드는데 외부 API를 써야 하는 초보자
“이 API 쓸까, 저 API 쓸까?” 헷갈리는 분
무료 API가 많을 때 어떤 걸 고를지 몰라하는 분
진행 방법
1. 왜 필요했나
Day 4에서 사무실 주소를 저장하는데, 주소로부터 시간대도 함께 얻어야 했어요.
흐름:
사용자가 “Times Square, New York” 입력
Photon API로 주소 → 좌표(위도, 경도) 변환
Timezone API로 좌표 → 시간대(America/New_York) 변환
둘을 함께 저장
Timezone API는 많은데, 어느 걸 고를지가 문제였어요.
2. 첫 번째 벽: “무료 Timezone API가 6개야?”
웹에서 찾은 것:
API
무료 할당량
가입 난도
API Ninjas
월 10,000건
⭐⭐ 이메일 인증만
TimeZoneDB
월 2,500건
⭐⭐⭐ 회원가입 필수
Geoapify
일 3,000건
⭐⭐⭐ 이메일 인증
월 30,000건(IP)
⭐⭐⭐ 복잡
Azure Maps
무료 평가판
⭐⭐⭐⭐ 기업용
Google Maps API
유료 ($0.07/건)
⭐⭐⭐
“최고의 API”를 고르려니 고민이 많았어요. Google은 정확하지만 유료고, Azure는 안정적이지만 회원가입이 복잡했거든요.
3. 판정 기준 바꾸기
그런데 생각해보니, “가장 좋은” API를 고를 이유가 없더라고요.
내 상황:
혼자 개발 중 (팀이 아님)
앱이 완성되지 않았음 (Day 4일 뿐)
나중에 바꿀 수 있음
그래서 기준을 바꿨어요:
기준
답
기술 성능?
”지금은 안 중요”
무료 할당량?
”충분하면 OK”
붙이기 쉬운가?
”이게 제일 중요”
4. 해결: API Ninjas로 정하기
선택 이유:
1단계: 가입
메일 주소만 넣으면 됨 (회원가입 폼 없음)
2분이면 끝남
2단계: API 키 복사
https://api-ninjas.com/account
↓
X-Api-Key: xxxxxxxxxxxxx (한 줄 복사)3단계: 코드에 붙이기
const tzResponse = await fetch(
`https://api.api-ninjas.com/v1/timezone?lat=${lat}&lon=${lon}`,
{ headers: { 'X-Api-Key': process.env.NEXT_PUBLIC_API_NINJAS_KEY } }
);할당량도 월 10,000건이니, Day 4~7 테스트하는 데는 충분해요. (하루에 100건도 안 함)
🛠 사용한 도구
도구
역할
Google 검색
”free timezone api” 검색
각 API 사이트
가입 난도, 문서, 할당량 확인
표 만들기
6개 API 비교 정리
배운 점
💡 핵심 교훈
1. “최고의” 선택이 아니라 “지금 내 상황에 맞는” 선택을 하자
초보자일 때는 “가장 좋은” API를 고르려고 합니다. 하지만 처음부터 완벽하게 고를 수 없어요. API Ninjas를 선택해도 나중에 Google로 바꿀 수 있으니까요.
2. 무료 할당량은 “충분한가”가 기준이지, “가장 많은가”가 아니다
Azure: 월 125만 건 (오버킬)
Geoapify: 일 3,000건 (충분)
API Ninjas: 월 10,000건 (충분)
넉넉하면 되지, 제일 많을 필요는 없어요.
3. 기술보다 “붙이기 쉬운 것”을 먼저 본다
기술 점수 100점인 API도, 가입에 30분 걸리고 설정이 복잡하면 초보자는 못 씁니다.
가입: 2분 ✓
문서: 명확함 ✓
예제: 있음 ✓
이게 진짜 중요한 기준이에요.
적용할 점
🎯 결과
항목
선택
API
API Ninjas
무료 할당량
월 10,000건
예상 가입 시간
2분
나중에 바꿀 수 있나?
Yes (Google로 쉽게 마이그레이션 가능)
📋 다음 API를 고를 때 체크리스트
기술 성능은 “충분한” 수준?
무료 할당량은 “충분한” 양?
가입이 “2~5분” 안에 끝남?
문서가 명확함?
예제 코드가 있음?
처음부터 완벽할 필요는 없고, 나중에 바꿀 수 있나?
🔜 앞으로
Day 6~7에 실제로 API를 붙여보면서, “API Ninjas 선택이 맞았나” 확인하겠습니다. 만약 부족하다면 그때 Google로 옮기면 되고요.
솔직한 소감
처음엔 “Google Maps가 가장 정확하고 안정적인데, 그 API로 해야 하나?” 고민했습니다.
그렇지만 일단 “빨리 만들어서 시험해보고, 부족하면 나중에 바꾼다”가 초보에게는 제일 빠른 길인 것 같습니다.