Google is committed to advancing racial equity for Black communities. See how.

제품 업데이트

여러 API가 업데이트되었습니다. 아래에서 자세한 내용을 확인하세요.

지도

지도에는 제품 변경사항이 없습니다. API별 결제 변경사항을 확인해 보세요.

경로

경로에는 제품 변경사항이 없습니다. API별 결제 변경사항을 확인해 보세요.

장소

장소 세부정보

장소 세부정보 요청을 특정 필드로 제한할 수 있습니다.

장소 세부정보 요청이 지정된 필드만 반환하도록 업데이트되었습니다. 이전에는 장소 세부정보 요청이 지정된 장소와 관련된 사용 가능한 데이터를 모두 반환했습니다. 이번 변경에 따라 응답이 fields 매개변수를 사용하여 지정된 필드로만 제한됩니다. 이러한 필드에 해당하는 장소 세부정보 결과가 반환되며, 필드는 3가지 결제 카테고리인 Basic, Contact, Atmosphere로 분류됩니다. 각 요청의 비용은 선택한 필드에 따라 달라집니다. 지정된 필드가 없으면 지정된 장소에 대해 가능한 모든 데이터가 반환되며, 최대 금액이 청구됩니다.

모든 장소 세부정보 요청에 대한 비용은 기본 요율로 청구됩니다.

Basic 카테고리는 추가 비용이 발생하지 않으며 다음과 같은 필드가 포함됩니다.

address_component, adr_address, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity

Contact 카테고리는 추가 비용이 발생하며 다음과 같은 필드가 포함됩니다.

formatted_phone_number, international_phone_number, opening_hours, website

Atmosphere 카테고리는 추가 비용이 발생하며 다음과 같은 필드가 포함됩니다.

price_level, rating, review

참고: 저작자 표시(html_attributions)는 요청되었는지에 관계없이 모든 호출에 반환됩니다.

다음과 같은 작업이 가능합니다.

  • 앱을 평가하여 현재 어떤 장소 세부정보 데이터를 사용하고 있는지 확인할 수 있습니다.
  • 코드를 업데이트하여 fields 매개변수를 추가할 수 있습니다.
  • Google Cloud Platform Console에 로그인하여 현재까지의 Places API 사용량을 확인할 수 있습니다. Console과 관련하여 도움이 필요하면 Google 계정 고객센터를 이용하세요.

fields 매개변수를 사용하여 장소 세부정보 요청에 대해 값을 반환할 필드를 지정할 수 있습니다. 아래의 예시에는 name, rating, formatted_phone_number 필드가 지정되어 있습니다.

웹 서비스

https://maps.googleapis.com/maps/api/place/details/json?placeid={PLACE_ID}&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY 

자바스크립트

const placeId = 'not_actually_a_place_id';
const request = {
  placeId: placeId,
  fields: ['name', 'rating', 'formatted_phone_number']
};
const service = new google.maps.places.PlacesService(map);
service.getDetails(request, callback); 

장소 찾기

웹 서비스

입력한 텍스트 또는 전화번호를 바탕으로 장소를 반환하는 새로운 서비스 장소 찾기가 웹 서비스에 도입되었습니다. 이름, 주소, 전화번호 등 모든 유형의 장소 데이터를 텍스트로 입력할 수 있습니다. 필요한 필드를 받으려면 장소 찾기에서 fields 매개변수를 사용해야 합니다. Basic, Contact 또는 Atmosphere 카테고리의 필드는 장소 세부정보 요청과 동일한 방식으로 비용이 청구됩니다. 지정된 필드가 없으면 발견된 장소의 PlaceId가 반환되며 비용이 청구되지 않습니다.

다음과 같은 작업이 가능합니다.

기존의 장소 검색 요청을 마이그레이션하여 장소 찾기를 사용할 수 있습니다.

자바스크립트

자바스크립트용으로 새로운 Find Place API 2개가 도입되었습니다. Find Place From Query 서비스에서는 텍스트 쿼리를 입력하면 장소가 반환됩니다. 쿼리에는 이름, 주소와 같은 모든 유형의 장소 데이터를 입력할 수 있습니다. Find Place From Phone Number 서비스에서는 전화번호를 입력하면 장소가 반환됩니다. 필요한 필드를 받으려면 2가지 Find Place API에서 모두 fields 매개변수를 사용해야 합니다. Basic, Contact 또는 Atmosphere 카테고리의 필드는 장소 세부정보 요청과 동일한 방식으로 비용이 청구됩니다. fields 매개변수가 필요하며, 필드가 지정되지 않으면 요청에서 오류가 발생합니다.

다음과 같은 작업이 가능합니다.

기존의 텍스트 검색 요청을 마이그레이션하여 대신 장소 찾기를 사용할 수 있습니다.

아래의 예에는 'Museum of Contemporary Art Australia'(오스트레일리아 현대 미술 박물관)에 대한 Places API 웹 서비스 장소 찾기 요청이 나와 있습니다. 이 요청에는 photos, formatted_address, name, rating, opening_hours, geometry 필드가 포함되어 있습니다.

웹 서비스

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY

자바스크립트

var map;
var service;
var infowindow;

function initMap() {
  var circularquay = new google.maps.LatLng(-33.8617374,151.2021291);

  map = new google.maps.Map(document.getElementById('map'), {
    center: circularquay,
    zoom: 15
  });

  var request = {
    query: 'Museum of Contemporary Art Australia',
    fields: ["photos", "formatted_address", "name", "rating", "opening_hours", "geometry"],
  };

  service = new google.maps.places.PlacesService(map);
  service.findPlaceFromQuery(request, callback);
}

function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    for (var i = 0; i < results.length; i++) {
      var place = results[i];
      createMarker(results[i]);
    }
  }
}

장소용 모바일 SDK

현재 Google에서는 새 버전의 Places SDK for AndroidPlaces SDK for iOS를 준비하고 있습니다. 변경되는 내용과 사용자에게 미치는 영향을 아래의 섹션에서 확인해 보세요.

  • 새로운 Places SDK for Android는 독립형 라이브러리로 제공되며, Google Play 서비스를 통해서는 더 이상 사용할 수 없게 됩니다. 새 버전은 기존의 SDK와 호환되지 않습니다.
  • 새로운 Places SDK for iOS가 제공됩니다.

Places API의 전체적인 변경사항을 반영하여 Places SDK의 여러 기능이 업데이트되며, 이 사항은 모바일 플랫폼인 Android와 iOS에도 적용됩니다.

  • 장소 세부정보(Android, iOS) 요청에 새로운 fields 매개변수가 추가됩니다.
  • 자동 완성 결제가 세션 기반으로 이루어집니다.

앞으로 몇 개월에 걸쳐 새 SDK 버전으로 마이그레이션하기 위한 일정과 리드 타임 등의 세부정보를 제공할 계획입니다. 새 버전이 기존 버전의 SDK를 대체하게 됩니다. 기존의 SDK는 적절한 일정에 따라 지원이 중단됩니다.

Maps Elevation API

Google Maps Platform이 출시됨에 따라 Maps Elevation API에 액세스하려는 신규 고객은 지원팀에 문의해야 합니다. 키가 없이 이 API를 이용 중인 사용자는 최대한 빨리 Google Cloud 계정에 가입하고 Maps Elevation API를 사용 설정하시기 바랍니다.

할당량

새로운 초당 쿼리 수(QPS) 제한 및 사용량 한도

일일 할당량 한도(QPD)가 사용 중지되고, 대부분의 서비스에서 한도를 높인 새 기준인 초당 쿼리 수(QPS) 제한이 사용됩니다. 기존의 모든 셀프 서비스 고객이 자동으로 새로운 QPS 제한 및 한도로 이전됩니다.

API 기존의 기본 사용량 한도 새로운 기본 사용량 한도

경로

100,000 QPD, 50 QPS

50 QPS

거리 행렬

100,000 EPD, 100 EPS

1,000 EPS

고도

100,000 QPD, 50 QPS

100 QPS

지오코딩

100,000 QPD, 50 QPS

50 QPS

위치정보

100,000 QPD, 50 QPS

100 QPS

동적 지도

100,000 QPD

500 QPS

정적 지도

100,000 QPD

500 QPS

Street View Image API

100,000 QPD

500 QPS

시간대

100,000 QPD, 50 QPS

500 QPS

장소(자바스크립트 및 웹)

150,000 QPD

100 QPS

도로

100,000 QPD

500 QPS

*EPS = 초당 요소 수, EPD = 일일 요소 수, QPS = 초당 쿼리 수, QPD = 일일 쿼리 수

이전의 기본 API 일일 할당량 제한을 이용해 요청을 제한하고 있는 경우 Google Cloud Platform Console에서 프로젝트에 일일 할당량 한도를 추가하여 같은 방식으로 할당량을 관리할 수 있습니다. 자세히 알아보기

브랜드 및 제품 이름 변경

브랜드와 제품 이름이 어떻게 변경되나요?

먼저, 브랜드 이름이 Google Maps Platform으로 변경되었습니다. 이 플랫폼에는 잘 알려진 인기 API가 그대로 포함되어 있으며, 결제 방식이 단순화되고 비즈니스 성장에 따라 사용 규모를 조절하기가 더욱 쉬워졌습니다. 또한 게임, 차량 공유, 애셋 추적 업계에서 사용할 수 있는 종합 솔루션을 제공합니다. 앞으로 200여 국가 및 지역에서 10억 명이 넘는 사용자가 Google 지도 인프라를 계속 사용하도록 지원할 계획입니다.

둘째로, Google Maps Platform에서는 API 구성이 지도, 경로, 장소 등 3개의 핵심 제품으로 단순화되었습니다. 각 제품에는 여러 기능이 포함되어 있으며, 다양한 API가 기능을 지원합니다. 제품별 기능과 API를 확인하려면 Google Maps Platform의 문서 페이지를 방문하세요.

셋째로, API의 이름과 결제 SKU가 더욱 쉽게 찾고 사용할 수 있도록 단순화되었습니다. 아래에서 새 이름을 확인하세요. 새 SKU가 실행되는 방식을 자세히 알아보려면 결제 이해 가이드를 참조하세요.

API 이름 변경

이전 이름 새 이름

Google Maps Android API

Maps SDK for Android

Google Maps Directions API

Directions API

Google Maps Distance Matrix API

Distance Matrix API

Google Maps Geocoding API

Geocoding API

Google Maps Geolocation API

Geolocation API

Google Maps JavaScript API

Maps JavaScript API

Google Maps Roads API

Roads API

Google Maps SDK for iOS

Maps SDK for iOS

Google Maps Time Zone API

Time Zone API

Google Places API for Android

Places SDK for Android

Google Places API for iOS

Places SDK for iOS

Google Places API Web Service

Places API

Google Static Maps API

Maps Static API

Google Street View Image API

Street View API

Places Library in the Maps JavaScript API

Places Library, Maps JavaScript API

결제 SKU 이름 변경

제품 결제 SKU: 새 이름 설명

지도

Static Maps

정적 지도를 표시합니다. 지도에서 사용할 맞춤 아이콘, 선, 색상, 다각형, 이미지를 지정할 수 있습니다.

Dynamic Maps

대화형 지도를 표시합니다. 확대/축소, 손가락 모으기, 회전 및 기울이기를 통해 지도를 더욱 자세히 살펴볼 수 있습니다. 또한 스타일을 지정할 수 있습니다.

Static Street View

정적인 스트리트 뷰, 360도 파노라마 사진, 미리보기 이미지를 표시합니다.

Dynamic Street View

대화형 스트리트 뷰, 360도 파노라마 사진, 미리보기 이미지를 표시합니다.

경로

Directions

운전, 도보, 자전거, 대중교통 경로를 보여주고, 최대 10곳의 경유지가 포함된 경로를 생성합니다.

Directions Advanced

다중 모드로 경로를 보여주고, 최대 25곳의 경유지가 포함된 경로를 생성하며, 실시간 교통정보를 알려줍니다.

Distance Matrix

1곳 이상의 위치에 대한 이동 시간과 거리를 알려줍니다.

Distance Matrix Advanced

실시간 교통정보를 바탕으로 1곳 이상의 위치에 대한 이동 시간과 거리를 알려줍니다.

Roads - Route Traveled

경로 1개를 따라 최대 100곳에서 GPS 신호를 수집하여 이동한 경로를 파악하고 일정을 생성합니다.

Roads - Nearest Road

최대 100개의 독립된 좌표를 이용해 가장 가까운 도로를 찾습니다.

장소

Basic Data

1억 곳이 넘는 장소 및 관심 장소의 이름과 주소를 제공합니다.

Contact Data

1억 곳이 넘는 장소 및 관심 장소의 이름, 주소, 연락처 정보를 제공합니다.

Atmosphere Data

1억 곳이 넘는 장소 및 관심 장소의 이름, 주소, 연락처 정보와 평점, 분위기 등의 세부정보를 제공합니다.

Places Photo

고화질 사진을 장소 및 관심 장소에 추가하고 수백만 개의 사진을 볼 수 있습니다.

Places - Text Search

검색 문자열(예: '냉면 맛집') 기반의 주변 장소 목록을 반환합니다.

Places - Nearby Search

사용자 위치 기반의 주변 장소 목록을 반환합니다.

Find Place

전화번호, 주소 또는 이름으로 장소를 찾고, 이름과 주소를 제공합니다.

Autocomplete with Details

자동 완성을 통해 추천 장소와 장소 정보를 제공합니다.

Autocomplete - Per Request

사용자가 주소 또는 장소명을 입력하면 자동 완성을 통해 추천 장소를 제공합니다. 입력한 문자수를 기준으로 비용이 청구됩니다.

Autocomplete - Per Session

사용자가 주소 또는 장소명을 입력하면 자동 완성을 통해 추천 장소를 제공합니다. 세션을 기준으로 비용이 청구됩니다.

Geolocation

Wi-Fi 또는 기지국을 바탕으로 기기의 위치와 오차 범위를 반환합니다.

Geocoding

주소를 지리 좌표로, 또는 그 반대로 변환합니다.

Time Zone

지리 좌표와 날짜를 기준으로 위치의 시간대를 반환합니다.

Google Maps Platform 사용 설정

API를 사용 설정하고 결제를 설정하기 위한 단계를 안내해 드립니다.

  1. 아래에서 제품 선택
  2. 프로젝트 선택
  3. 결제 설정

사용자에게 장소의 실제 모습을 보여주는 맞춤설정된 지도 환경을 구축하세요.

사용자에게 출발지에서 목적지까지 가는 최적의 경로를 알려주세요.

풍부한 세부정보로 사용자의 장소 탐색을 도와주세요.

계속