[기술 정보] Google Maps API Free 버전에서 Premium 버전 이동 Tips

Google Maps API를 활용해서 앱을 만들 때, 상당히 많은 개발자들이 Free 버전으로 개발한 후, 실제 앱을 출시하기 직전에 Premium 버전(Google Maps APIs for Work)으로 옮기는 경우가 많습니다. Google Maps API for Work는 하루에 사용할 수 있는 쿼타(Quota)와 초당 쿼타를 더 많이 제공하며, Premium 지원 채널에 대한 접근권한을 제공합니다. Premium 버전 사용 시작을 위한 몇 가지 중요한 팁을 소개합니다.

  1. Client ID 적용하기
  2. 도메인 권한부여
  3. 암호화 키(Crypto Key)로 웹서비스 요청 권한부여하기

1. Client ID 적용하기

Google Maps APIs for Work 고객이 되시면, 환영 이메일(Welcome Letter)과 함께 Client ID가 전달됩니다. Welcome Letter는 기술 담당자에게 보내지게 되는데, 만약 웰컴레터를 받지 못하신 경우, Google for Work Support Portal에 방문하시면 Client ID를 확인하실 수 있습니다.

migrating_1

구글은 Client ID로 사용자와 사용자의 앱을 구분합니다. 우선, 이전에 사용되었던 Product Key는 Client ID로 대체될 것입니다. 아래 예제는 Client ID(gme-droidsdonuts) 사용 전-후 시나리오를 보여줍니다.

migrating_2

v 파라미터는 로딩해야 하는 API 버전을 명시합니다. Maps For Work 고객은 항상 최신버전을 사용해야 하며, v=3이라고 명시하시면 됩니다. 더 많은 정보는 versioning guide에서 확인하실 수 있습니다.

Chrome 개발도구는 Client ID가 적용되었는지, API call에서 아직 대체되지 않은 Product Key가 있는지 등을 확인하는 어플리케이션의 HTML을 시각적으로 쉽게 리뷰할 수 있도록 해 줍니다. 그리고, Google for Work Support Portal은 페이지뷰 기록과 Client ID로부터 만들어진 웹서비스 요청 기록을 보여줍니다. 이 두 가지 방법을 잘 활용한다면, 앱이 Premium 서비스로 출시되었는지 확인할 수 있습니다.

 

2. 도메인 사용권한 부여하기

Premier 버전을 사용한 프로젝트와 앱의 안전이 보장되어야 합니다. 그래서, 구글은 사용권한이 확인된 도메인만 당신의 Client ID를 사용하고 있는지 보장하기 위해서, 항상 당신의 API 요청을 인증할 것입니다. 즉, 사용권한이 확인되지 않은 어떤 도메인으로부터의 API 요청이든 에러를 리턴할 것이고, 당신의 쿼타(Quota)에 반영되지 않을 것입니다.

Google for Work Support Portal에서 사용권한이 확인된 도메인을 확인할 수 있고, 언제든지 추가적인 도메인에 사용권한을 줄 수 있습니다. 만약 관련해서 어떤 문제가 있다면, Troubleshooting Guidelines을 확인하거나 Support에서 도움을 요청하세요.

migrating_3

3. 암호화 키(Crypto Key)로 웹서비스 요청 사용권한 부여하기

Client ID 뿐만 아니라, 지오코딩, 길찾기, 거리 매트릭스 등의 Google Maps Web Service API는 사용권한 확인을 위해 암호화 로그인 키(Cryptographic signing key)가 있는 추가적인 레이어가 필요합니다. 암호화 키(Crypto Key)는 Web Service API 요청이 당신의 Client ID와 사용권한이 확인된 도메인을 항상 포함하도록 함으로써, 믿을 수 있는 출처인지 보장해줍니다

암호화 키 자체가 서명이 아니라, 서명을 간단히 생성하도록 돕는 것이라는 것을 기억하세요. 비밀번호처럼 공유되면 안 됩니다. 더 많은 내용은 Authentication and Authorization 페이지에서 확인하세요.

 

이제 Client ID를 적용했고, 사용권한이 확인된 도메인도 세팅되었고, 암호화 키(Crypto Key)를 사용해서 Signature을 생성하였습니다. 이제 더 많은 쿼리 수, business-friendly SLA 와 support가 보장되는 자신감을 가지고 당신의 앱을 오픈할 준비가 되었습니다. 만약 더 많은 질문이 있으시다면, 제품과 관련된 FAQ, 문서, 다른 정보가 많이 있는 개발자 문서를 확인하세요.

API와 관련된 예상 밖의 문제가 생긴다면, CASE를 Support 팀에게 보내주세요. 최대한 빨리 문제를 해결해드리겠습니다. Product key를 Client ID로 대체하는 단계별 튜토리얼을 보고싶다면, 위의 video를 참고하세요.

 

>> 원문보기 (영문)