Positionstack API를 사용하여 엔터프라이즈급 지오코딩을 무료로 받으세요(검토)

지오코딩에서 가치를 얻기 위해 Google 지도가 될 필요는 없습니다. 그리고 Positionstack 덕분에 Big G의 기술 예산도 필요하지 않습니다. 오늘 우리는 엔터프라이즈 수준의 정방향 및 역방향 지오코딩을 매우 저렴하고 유용하게 만드는 것을 목표로 하는 Positionstack의 강력한 API를 검토합니다.

위치 스택 101

그렇다면 왜 Positionstack 에서 2,000개 이상의 단어 리뷰를 읽는 것을 귀찮게 해야 하며 무엇을 얻을 수 있습니까? 대답은 귀여운 소리, 그러나 그것은 정확 : 전 세계를 .

세계 지도에 얼마나 많은 장소가 있는지 잠시 생각해 보십시오. 이제 비즈니스에서 해당 장소에 대해 알아야 하는 모든 메타데이터에 머리 속의 숫자를 곱하십시오. 이것이 바로 Positionstack이 제공하는 것입니다.

Positionstack에 대한 몇 가지 빠른 통계를 살펴보겠습니다.

• 매일 매시간 처리되는 수십억 건의 지오코딩 조회 요청 100% 가동 시간 및 < 100ms="" response="">
• 확장성이 뛰어난 클라우드 기반 인프라
• 몇 시간마다 업데이트되는 동굴 같은 데이터 세트로 컴파일된 전 세계 모든 국가의 실시간 데이터
• 관대하게 배분되고 경쟁력 있는 가격의 구독 계획; 또한 무료 사용자를 위한 타의 추종을 불허하는 10,000개 요청 월 할당량
• 모든 주요 프로그래밍 언어에 대한 통합 지원
• 코드 조각으로 완성된 포괄적이고 읽기 쉬운 문서
• Zendesk, Slack, LinkedIn, Lyft, Apple 및 Amazon과 같은 고객에게 서비스를 제공한 경험이 있는 세계적 수준의 고객 만족 팀

Positionstack은 확실히 혈통을 확인하고 있지만 몇 가지 글머리 기호로 확신할 수 없는 경우 API를 실제로 사용하는 것이 어떤 것인지 자세히 살펴보겠습니다.

Positionstack의 3단계 빠른 시작 가이드

웹 사이트에서 시간을 보내면 Positionstack이 API의 주요 판매 포인트로 사용 편의성을 정말 강조한다는 것을 알 수 있습니다. 가입 과정에서 그것이 사실임을 즉시 알 수 있습니다. 사실, 계정 자격 증명을 입력한 후 가장 먼저 보게 되는 것은 간단한 세 단계로 Positionstack을 시작하고 실행하는 데 필요한 빠른 로드맵입니다. 한 번 보자:

1. API 액세스 키 설정 – 기본적으로 즉시 사용할 수 있는 액세스 키가 제공됩니다. 그러나 필요에 따라 이를 쉽게 재설정할 수 있습니다.
2. API 엔드포인트 선택 – 다음 섹션에서 API 엔드포인트를 더 자세히 다루지만 지금은 이 단계가 앱이 Positionstack에 요청할 때 반환되는 데이터 유형을 구성하는 것을 의미한다는 점만 이해하면 됩니다. 여기에서 요청을 대상으로 하는 기본 URL이 먼저 표시되지만 설명서에도 표시됩니다. 마지막으로 몇 줄의 쉬운 코드로 구성된 샘플 API 요청을 볼 수 있습니다.
3. 애플리케이션 통합 – 마지막 단계는 Positionstack의 API를 애플리케이션에 최종적으로 통합하는 것입니다. 이 프로세스에 대해 알아야 할 사항이 상당히 많으며 대부분은 문서에서 다룹니다. 여기서 중요한 점은 Positionstack의 지원 팀이 귀하의 지원을 받으며 API를 구성하고 앱에 통합하는 데 필요한 도움을 최대한 많이 또는 거의 제공하지 않는다는 것입니다.

꽤 쉽죠? API는 처음에는 광범위한 IT 지식이 없는 사람들에게 위협적으로 보일 수 있습니다. 그러나 곧바로 Positionstack은 쉬울 뿐만 아니라 스마트 디자인에 대한 놀라운 문서화로 도움이 될 것이라는 지식으로 당신을 위안합니다. 그것은 그들이 당신을 도울 준비가 된 열정적인 전문가 팀을 갖는 데 도움이됩니다.

포지션스택 대시보드

사용자 친화성의 핵심 가치를 두 배로 낮추는 Positionstack은 API에 대해 알아야 할 모든 것에 액세스할 수 있는 능률적이고 깔끔한 대시보드를 제공합니다. 사이드바 옵션을 살펴보겠습니다.

• 대시보드 – 여기에서 알림(일반적으로 특정 사용 임계값을 초과하면 경고)을 찾은 다음 3단계 빠른 시작 가이드와 해당 문서 페이지에 대한 링크를 찾을 수 있습니다. API 키, 현재 구독, 계정 세부 정보 및 지불 방법에 대한 개요도 있습니다.
• 업그레이드/구독 – 이 두 가지 옵션 중 하나에서 구독을 변경할 수 있습니다. 월간 또는 연간 요금제를 어느 방향으로든 전환하려면 먼저 무료 계정으로 다운그레이드한 다음 원하는 옵션을 선택해야 합니다. 이 작업을 수행하는 데 도움이 필요한 경우 Positionstack 지원이 기꺼이 도와드릴 것입니다.
• 계정/지불 – 이는 자명합니다. 두 탭에서 언제든지 자격 증명을 업데이트할 수 있습니다. 지나치게 디자인되고 화려한 인터페이스에 이러한 기본 컨트롤을 묻지 않는다는 점에 감사해야 합니다. 위지윅.
• API 사용 – 아마도 가장 자주 다시 방문하게 될 탭으로 여기에서 지금까지 월별 요청 할당량을 얼마나 소모했는지 확인할 수 있습니다. 시간 경과에 따른 사용 통계를 보여주는 편리한 섹션도 있으므로 그에 따라 전략을 조정할 수 있습니다.

API 문서

이제 우리는 Positionstack이 제공하는 API 문서 의 핵심과 영혼을 다룹니다 . 각 API 엔드포인트, 해당 매개변수 및 반환할 정보의 종류에 대해 자세히 설명하는 이 페이지를 사용자 매뉴얼로 고려하십시오.

이 페이지는 5개의 다른 섹션으로 나뉩니다. 우리는 각각을 살펴보고 당신이 찾을 내용을 더 잘 이해할 수 있도록 약간의 컨텍스트를 제공하기 위해 약간의 시간과 말을 할 것입니다.

시작하기

여기에서 Positionstack으로 만드는 모든 요청에 ​​적용되는 기본 기능 을 찾을 수 있습니다. 이것들은:

• API 키 – API 키는 Positionstack의 데이터 세트에 액세스하는 데 사용할 디지털 여권과 같습니다. 그것이 없으면 API는 당신에게 쓸모가 없습니다. 손상되었다고 생각되면 이전 키를 새 키로 쉽게 교체할 수 있습니다.
• 암호화 – 256비트 SSL 암호화는 인터넷 전체에서 사용되며 보안에 대한 업계 표준입니다. Positionstack의 서버와 앱의 통신을 암호화하려면 기본 계획 이상이 필요하지만 그 자체로 투자할 가치가 있습니다. 암호화를 유발하려면 API 기본 URL에서 HTTP를 HTTPS로 변경하기만 하면 됩니다. 단순한!
• JSON 콜백 – 이것이 어떻게 작동하는지에 대한 기술적인 세부 사항을 너무 많이 다루지는 않겠지만 API 요청이 동일 출처 정책에 의해 막힌 경우 JSON 콜백을 사용하여 해결 방법에 영향을 미칩니다. 기본적으로 외부 스크립트에서 데이터를 요청하므로 도메인 간 문제가 발생하지 않습니다.
• API 오류 – 다른 모든 것과 마찬가지로 때때로 API 요청에 오류가 발생합니다. Positionstack은 이를 이해하고 무엇이 잘못되었는지 식별하는 데 도움이 되는 오류 보고 기능을 앱에 내장했습니다. API 요청 실패는 자동으로 JSON 형식의 오류 개체와 함께 오류에 대한 컨텍스트를 제공하는 코드, 메시지 및 컨텍스트 하위 개체를 반환합니다.

API 엔드포인트

이 섹션에서는 Positionstack의 고기와 감자 기능, 즉 정방향 및 역방향 지오코딩에 대해 설명합니다. 차이점이 무엇인지 100% 확신할 수 없다면 지오코딩을 일반 영어로 작성된 장소와 주소를 좌표 및 IP 주소와 같은 위치 데이터로, 그리고 그 반대로 번역할 수 있는 양방향 도로라고 생각하십시오.

따라서 정방향 지오코딩을 사용하여 에펠탑의 위치를 ​​좌표로 변환합니다. 마찬가지로 역 지오코딩을 사용하여 IP 주소와 연결된 거리 주소를 찾을 수 있습니다. 어쨌든 아주 간단합니다!

정방향/역방향 지오코딩 요청

두 가지 유형의 지오코딩에 대한 기본 요청을 하려면 적절한 엔드포인트( /forward  또는 /reverse )를 API의 기본 URL 에 추가해야 합니다 . 다음으로 액세스 키를 제공한 다음 일반 영어 위치 주소 또는 해당 위치 데이터를 사용하여 쿼리 합니다. 그리고 짜잔! 다음과 같이 보일 것입니다.

https://api.positionstack.com/v1/forward
    ? access_key = 귀하의_ACCESS_KEY
    & 쿼리 = 1600 Pennsylvania Ave NW, Washington DC

또는

https://api.positionstack.com/v1/reverse
    ? access_key = 귀하의_ACCESS_KEY
    & 쿼리 = 40.7638435,-73.9729691

물론, Positionstack의 데이터 세트에는 주소와 좌표 그 이상이 포함되어 있습니다. 다양한 매개변수를 사용하여 이러한 다른 분류를 구문 분석할 수 있습니다. 다음 은 백악관에 쿼리 하는 정방향 지오코딩 요청 의 예입니다 .

{
   "데이터": {
      "결과": [
         {
            "위도": 38.897675,
            "경도": -77.036547,
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, USA",
            "이름": "1600 Pennsylvania Avenue NW",
            "유형": "주소",
            "숫자": "1600",
            "street": "Pennsylvania Avenue NW",
            "우편번호": "20500",
            "자신감": 1,
            "지역": "컬럼비아 특별구",
            "region_code": "DC",
            "administrative_area": ​​null,
            "이웃": "백악관 부지",
            "국가": "미국",
            "country_code": "미국",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

흥미롭게도 백악관의 대략적인 좌표를 사용하여 역 지오코딩 요청 을 수행하는 경우 반환된 결과는 거의 동일하게 보일 것입니다. 단, Positionstack의 좌표와 백악관 공식 좌표 간의 거리 차이도 표시됩니다. 데이터 세트.

이러한 유사성의 이유는 두 엔드포인트가 동일한 GET 매개변수 배열을 사용하므로 동일한 응답 객체를 (거의) 반환할 수 있기 때문입니다. 즉, 어떤 시작 데이터로 이동하든 관계없이 위치 데이터를 완전히 보완할 수 있습니다. (API의 fields  매개변수를 사용하여 이러한 결과의 범위를 좁힐 수 있지만 나중에 더 자세히 다룰 것입니다.)

참고: Positionstack의 문서 페이지는 각 매개변수와 응답 객체에 대해 자세히 설명하고 있으므로 반드시 확인하십시오!

일괄 요청

이 문서 설정의 마지막 주요 제목은 일괄 요청 을 다룹니다 . 일괄  매개변수를 호출 한 다음 단일 요청에서 아래에 여러 쿼리 인스턴스(원하는 매개변수와 함께) 를 중첩하기만 하면 Positionstack의 API가 나머지를 처리합니다. 매우 간단하며 다음과 같이 보입니다.

{
   "일괄":[
      {
         "쿼리": "메인 스트리트",
         "국가": "미국",
         "지역": "미네소타"
      },
      {
         "쿼리": "메인 스트리트",
         "국가": "미국",
         "지역": "일리노이"
      },
      {
         "쿼리": "메인 스트리트",
         "국가": "미국",
         "지역": "미주리"
      }
   ]
}

고급 데이터

기본 위치 매개변수 외에도 API 요청을 추가로 맞춤설정하여 고급 데이터 를 반환할 수 있습니다 . 여기에는 다음이 포함됩니다.

• 포함 가능한 지도 – 지오코딩 결과에 연결된 map_url 개체를 반환합니다. 이 개체를 사용하여 웹사이트나 앱에서 매력적인 시각적 지도 표현을 만들 수 있습니다.
• 국가 모듈 – 몇 개의 응답 개체를 반환하는 다른 매개변수와 달리 country_module 은 쿼리한 국가에 대한 놀라운 데이터 배열을 반환합니다. 좌표와 주소뿐만이 아닙니다. 그것은 수도, 국기, 공식 명칭, 내륙국(또는 비내륙국)으로서의 지위, 사용된 통화, 사용 언어, ​​호출 코드 등입니다.
• Sun Module – 유머러스하게도 Positionstack의 문서는 이것을 "점성학적" 데이터라고 설명합니다. 이 매개변수로 별자리 운세를 얻을 수는 없지만 천문, 민간 및 해상 연대기에 따라 해가 뜨고 지는 시점에 대한 데이터는 볼 수 있습니다.
• 시간대 모듈 – timezone_module 을 추가 하여 위치의 GMT 오프셋을 초 단위로 반환하거나 자연어 문자열로 반환합니다.
• 경계 상자 모듈 – 단일 x/y 좌표 쌍이 작업에 적합하지 않은 경우 경계 상자를 사용해 보십시오. 경계 상자는 경도와 위도의 최소값과 최대값이 있는 영역을 둘러쌉니다.

추가 옵션

Positionstack API에는 던질 데이터가 많지만 운 좋게도 이 정보를 관리하기 위한 추가 도구 를 제공합니다 .

• 응답 필드 지정 – Positionstack이 반환할 수 있는 데이터의 양에 대해 자세히 다루었지만 모든 데이터에는 비용이 따른다는 점을 명심하십시오. 월별 요청을 제한하려면 필드를 추가 하면 됩니다 . 예를 들어, 필드 추가 = results.flag 는 API가 쿼리한 국가의 플래그만 출력하도록 합니다. 필요한 특정 데이터 세트를 가져오는 데 필요한 만큼 필드 를 호출할 수 있습니다 .
• 출력 형식 지정 – 무료 구독자는 반환된 지오코딩 결과에 대해 JSON 형식으로 제한됩니다. 그러나 유료 고객 은 요청에 출력 을 추가 하여 필요에 따라 JSON, XML 또는 GeoJSON을 지정할 수 있습니다 . 

코드 예 

Positionstack이 당신을 도우러 왔다고 말할 때 그것은 의미합니다. 우리는 이미 그들의 문서가 얼마나 철저한지 보았지만 API가 지원하는 모든 언어로 된 편리한 코드 예제 로 마무리합니다. 여기에 해당 코드를 복사/붙여넣기하지는 않겠지만 빠른 참조를 위해 해당 언어는 다음과 같습니다.

• 파이썬
• 노드
• 제이쿼리
• 가다
• 루비

증거 및 성능

이 시점에서 Positionstack이 꽤 많은 일을 할 수 있다는 것이 분명해야 합니다. 그러나 이러한 작업을 얼마나 잘 수행합니까?

먼저 몇 가지 맥락을 살펴보겠습니다. Positionstack은 Apilayer의 클라우드 기반 에코시스템에 있는 20개 이상의 API 마이크로서비스 중 하나입니다. 함께 이러한 API는 신생 기업에서 기업에 이르기까지 백만 명이 넘는 B2B 클라이언트에 서비스를 제공합니다. 가장 주목할만한 고객에는 Amazon, Apple, Slack, LinkedIn 및 더 많은 가명이 포함됩니다. 분명히 그들은 이러한 규모의 수요를 처리할 수 있는 강력한 인프라를 갖추고 있습니다.

자체 장점으로 Positionstack은 작성 당시 2020년 내내 놀라운 100% 가동 시간으로 가계도에 부합합니다. API가 고래 클라이언트당 하루에 10억 개 이상의 지오코드 조회를 일상적으로 처리 한다는 점을 고려할 때 이것은 훨씬 더 인상적 입니다. 안정적인 SMB 고객으로부터 오는 어지러운 동시 요청 배열은 말할 것도 없습니다. 게다가 이러한 요청은 일반적으로 10~100ms 사이의 응답을 얻습니다.

우리 책에서 이는 특히 이 SaaS 제품의 가격이 얼마나 공격적인지를 고려할 때 기술적으로 놀라운 일입니다.

그리고 Positionstack을 매력적으로 만드는 것은 순수한 힘만이 아닙니다. 그들의 데이터 세트는 Nominatim, GeoNames, Pelias 및 OpenStreetMap과 같은 신뢰할 수 있는 이름에서 제공되는 정말 정교합니다. Positionstack은 이 풍부한 데이터를 하루에 여러 번 교차 확인, 필터링 및 재결합하여 전 세계 어디에서나 실시간으로 항상 매우 정확한 위치 데이터를 갖도록 하는 스마트 알고리즘을 통해 정기적인 업데이트를 푸시합니다.

최종 평결을 망치는 것을 싫어하지만 강력하고 확장 가능한 지오코딩 솔루션을 찾고 있다면 Positionstack의 이력서를 자세히 살펴봐야 합니다.

가격 

Apilayer는 고가의 엔터프라이즈급 지오코딩 소프트웨어에 대한 경제적인 대안을 제공하기 시작했고 이를 위해 성공했습니다.

Positionstack은 5가지 가격 계층으로 제공되며 20% 할인된 가격으로 월별 청구 또는 연간 구독을 지원합니다. 해당 계층은 다음과 같습니다.

• 무료 – 개인용으로 평가되며 JSON 형식으로 출력되는 정방향 및 역방향 지오코딩에 대한 25,000건의 월간 요청으로 여전히 상당한 마일리지를 얻고 있습니다. 고급 기능이나 고객 지원을 많이 받지는 못하지만 문서 페이지가 얼마나 귀중한 리소스인지 이미 보여주었습니다. 이 계층은 무료이며 의무도 없습니다. 시작하기 위해 신용 카드 세부 정보를 제공할 필요도 없습니다.
• 기본 – 보급형 상용 패키지. 기본 가입자는 월별 할당량을 100,000개의 지오코딩 요청으로 4배로 늘리고 HTTPS 암호화, 다중 출력 옵션(JSON, XML, GeoJSON), 포함 가능한 지도, 다중 언어 등과 같은 고급 기능에 액세스할 수 있습니다. 월 $9.99에 상업용 Positionstack 라이센스를 얻으십시오.
• Professional – Positionstack의 가장 인기 있는 제품인 Professional 계층은 10배 증가한 지오코딩 요청(월 최대 1,000,000)을 제공합니다. 기본 계층의 모든 기능이 있으며, 특히 중부하 응용 프로그램에 대한 일괄 요청을 포함하여 일부가 있습니다. 이 계층은 한 달에 $49.99입니다.
• 비즈니스 – 엔터프라이즈급 성능으로 이동하면서 비즈니스 계층은 월별 할당량을 무려 3,000,000건의 요청으로 확장합니다. 다시 한 번, 모든 고급 기능을 완전히 사용할 수 있으며, Positionstack의 열정적인 고객 지원 팀이 이를 최대한 활용할 수 있도록 지원합니다. 월 $99.99.
• 엔터프라이즈 – 이것은 표준 제안이 창 밖으로 사라지고 고객이 왕이 되는 계층입니다. 맞춤형 솔루션이 필요한 정확한 요구 사항이 있으며 Positionstack은 귀하의 목표를 달성할 준비가 되어 있습니다. 월간 볼륨 요청은 가변적일지라도 (특히) 지시합니다. API에서 더 많은 성능이 필요하십니까? 맞춤형 솔루션에 대한 지원을 받으십시오. 견적은 Positionstack에 문의하십시오.

평결

Positionstack은 원래 의도한 대로 정확하게 수행합니다. 즉, 성능 저하 없이 대부분의 SMB에 예산을 초과하지 않는 가격대에서 엔터프라이즈 수준의 지오코딩을 제공합니다. 그들의 API는 잘 문서화되어 있고 사용하기 쉽지만 최대의 유용성을 위해 모든 주요 프로그래밍 언어에 걸쳐 강력한 통합이 특징입니다. Positionstack이 일상적으로 처리하는 요청의 수는 어마어마하지만 실시간 지오코딩에서 진정한 글로벌 도달을 위해 데이터 세트가 현명하게 유지 관리됩니다. 이러한 유형의 제품을 시장에 내놓고 있다면 Positionstack에서 잠을 자지 마십시오.

어떤 종류의 통합을 계획하고 있습니까? 비즈니스에서 지오코딩을 어떻게 활용하시겠습니까? Positionstack에 대한 질문이나 의견이 있습니까? 아래 의견에 메모를 남겨주세요.