모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps Geocoding API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps Geocoding API 활성화
  3. 적합한 키 생성
계속

시작하기

Google Maps Geocoding API은 지오코딩과 주소의 역지오코딩을 제공하는 서비스입니다.

이 서비스는 또한 클라이언트측 Google Maps JavaScript API의 일부로 제공되거나 서버측에서 Java Client, Python Client, Go Client 및 Node.js Client for Google Maps Services와 함께 사용됩니다.

지오코딩은 주소(예: 도로 주소)를 지리 좌표(예: 위도 및 경도)로 변환하는 프로세스이며, 이 프로세스를 사용하여 마커를 지도에 넣거나 지도를 배치할 수 있습니다.

역지오코딩은 지리 좌표를 사람이 읽을 수 있는 주소로 변환하는 프로세스입니다. Google Maps Geocoding API의 역지오코딩 서비스를 사용하면 지정된 장소 ID에 대한 주소를 찾을 수도 있습니다.

샘플 요청 및 응답

HTTP 인터페이스를 통해 Google Maps Geocoding API에 액세스할 수 있습니다. 다음은 지오코딩과 역지오코딩 요청의 예입니다.

지오코딩 요청 및 응답(위도/경도 검색)

다음 예시는 "1600 Amphitheatre Parkway, Mountain View, CA"의 위도와 경도를 요청하고 그 결과를 JSON 형식으로 출력하도록 지정합니다.

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

웹 브라우저에 URL을 입력하여 이 요청을 테스트할 수 있습니다. (‘YOUR_API_KEY’는 실제 API 키로 대체하세요.) 응답에는 이 주소의 위도와 경도가 포함됩니다.

개발자 가이드에서 지오코딩 요청 URL 빌드이용 가능한 매개변수응답 이해에 관한 자세한 정보를 참조하세요.

다음은 JSON 형식의 샘플 지오코딩 응답입니다.

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "1600",
               "short_name" : "1600",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Amphitheatre Pkwy",
               "short_name" : "Amphitheatre Pkwy",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Mountain View",
               "short_name" : "Mountain View",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Santa Clara County",
               "short_name" : "Santa Clara County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "California",
               "short_name" : "CA",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "94043",
               "short_name" : "94043",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "1600 Amphitheatre Parkway, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4224764,
               "lng" : -122.0842499
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4238253802915,
                  "lng" : -122.0829009197085
               },
               "southwest" : {
                  "lat" : 37.4211274197085,
                  "lng" : -122.0855988802915
               }
            }
         },
         "place_id" : "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

역지오코딩 요청 및 응답(주소 검색)

다음 예시는 미국 뉴욕 주 브루클린에서 주어진 위도/경도에 해당하는 주소를 요청합니다. 결과를 JSON 형식으로 출력하도록 지정합니다.

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY

웹 브라우저에 URL을 입력하여 이 요청을 테스트할 수 있습니다. (‘YOUR_API_KEY’는 실제 API 키로 대체하세요.) 응답에는 위도 및 경도 위치에 대한 사람이 읽을 수 있는 주소가 포함됩니다.

개발자 가이드에서 역지오코딩 요청 URL 빌드이용 가능한 매개변수응답 이해에 관한 자세한 정보를 참조하세요.

다음은 JSON 형식의 샘플 역지오코딩 응답입니다.

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "277",
               "short_name" : "277",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Bedford Avenue",
               "short_name" : "Bedford Ave",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Williamsburg",
               "short_name" : "Williamsburg",
               "types" : [ "neighborhood", "political" ]
            },
            {
               "long_name" : "Brooklyn",
               "short_name" : "Brooklyn",
               "types" : [ "sublocality", "political" ]
            },
            {
               "long_name" : "Kings",
               "short_name" : "Kings",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "New York",
               "short_name" : "NY",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "11211",
               "short_name" : "11211",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "277 Bedford Avenue, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.714232,
               "lng" : -73.9612889
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.7155809802915,
                  "lng" : -73.9599399197085
               },
               "southwest" : {
                  "lat" : 40.7128830197085,
                  "lng" : -73.96263788029151
               }
            }
         },
         "place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
         "types" : [ "street_address" ]
      },

   ... Additional results truncated in this example[] ...

   ],
   "status" : "OK"
}

클라이언트 라이브러리로 코딩 시작하기

클라이언트 라이브러리를 사용하면 인증, 요청 차단, 자동 재시도와 같은 일반적인 작업을 간단하게 구현할 수 있으며, Google Maps Web Service API를 사용한 개발이 더욱 쉬워집니다. Google Maps Geocoding API는 Java Client, Python Client, Go Client 및 Node.js Client for Google Maps Services에서 이용할 수 있습니다.

인증, 할당량 및 정책

API 활성화 및 API 키 가져오기

Google Maps Geocoding API를 사용하려면 먼저 Google API Console에서 API를 활성화하고 적절한 인증 자격 증명을 획득해야 합니다. 각 요청에 API 키를 제공해야 합니다(또는 프리미엄 플랜일 경우 클라이언트 ID).

아래 버튼을 클릭하여 다음 절차를 수행합니다.

  1. 프로젝트 생성 또는 선택
  2. API 활성화
  3. API 키 가져오기
키 가져오기

인증 자격 증명에 대해 자세히 알아보세요.

할당량

사용자 제한 페이지에서 Google Maps Geocoding API의 할당량 설정에 관한 자세한 정보를 검토합니다.

정책

Google Maps Geocoding API를 사용할 때는 API 정책을 준수해야 합니다.

자세히 알아보기

그 외에도 Geocoding API의 기능은 다양합니다. 다른 데모, 예시, 이용 가능한 매개변수, 상태 코드, 오류 메시지 및 자세한 정보는 Geocoding API 개발자 가이드를 참조하세요.

다음에 대한 의견 보내기...

Google Maps Geocoding API
Google Maps Geocoding API
도움이 필요하시나요? 지원 페이지를 방문하세요.