시작하기

이 페이지에서는 장소 클래스를 사용할 수 있도록 API 키를 가져오고, 필요한 API를 사용 설정하고, 장소 라이브러리를 로드하는 방법을 보여줍니다.

API 키 가져오기 및 필수 API 사용 설정

장소 클래스를 사용하기 전에 다음을 실행해야 합니다.

  • 결제 계정으로 Cloud 프로젝트를 만듭니다.
  • API 키를 가져옵니다.
  • 다음 API를 사용 설정합니다.
    • Maps JavaScript API
    • Places API
    • Places API (신규) (텍스트 검색 (신규) 및 장소 자동 완성을 사용하기 위해 필요함)

자세한 내용은 Google Cloud 프로젝트 설정을 참고하세요.

API 키 가져오기

Places API(신규) 사용 설정

장소 라이브러리 로드

장소 라이브러리를 로드하려면 다음 스니펫과 같이 애플리케이션 코드에 인라인 부트스트랩 로더를 추가하여 Maps JavaScript API를 먼저 로드하세요. 

<script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "weekly",
    // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
    // Add other bootstrap parameters as needed, using camel case.
  });
</script>

그런 다음 아래와 같이 await 연산자를 사용하여 async 함수 내에서 importLibrary()를 호출합니다.

  const {Place} = await google.maps.importLibrary("places");

함수는 필요한 클래스의 변수를 선언하지 않고도 라이브러리를 로드할 수 있습니다.

  async function initMap() {
    google.maps.importLibrary("places");
    ...
  }

  initMap();

또는 다음과 같이 HTML에 라이브러리를 직접 로드할 수도 있습니다.

  <script>
  google.maps.importLibrary("places");
  </script>

라이브러리 로드에 관한 자세한 내용은 Maps JavaScript API 로드를 참고하세요.

다음 단계