날씨 지도 가져오기 (실험용)

이 제품 또는 기능은 실험용(GA 이전) 버전입니다. GA 이전 제품과 기능에 대한 지원이 제한될 수 있으며 GA 이전 제품과 기능의 변경사항이 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 또는 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참고하세요.

mapTypes 엔드포인트는 강수량 예측과 같은 다양한 날씨 현상을 나타내는 래스터 지도 타일을 제공합니다. 이러한 지도 타일은 표준 Google 지도에 오버레이될 수 있습니다.

참고: 날씨 지도 타일이 forecast:minute 엔드포인트에서 제공하는 데이터와 동기화되거나 정렬되지 않을 수 있습니다.

약관

이 약관은 Google과 귀하가 동의한 Google Maps Platform 서비스별 약관의 섹션 6 (GA 이전 버전 제품 및 서비스 약관)에 따라 발행됩니다.

1.1 저작자 표시 요구사항. 고객이 Weather API의 Google 지도 콘텐츠를 사용하는 경우 고객은 문서에 따라 Google에 저작자 표시를 제공해야 합니다.

1.2 제한사항. 고객은 Weather API에서 가져온 Google 지도 콘텐츠를 사용하여 Google 서비스 또는 제품을 다시 만들 수 없습니다 (예: 날씨 정보를 제공하는 것이 기본 목적인 날씨 앱 또는 날씨 모델에서 Weather API에서 가져온 데이터를 사용).

1.3 캐싱. 고객은 표 1.3.1 (캐싱 권한)에 설명된 대로 해당 캐싱 기간 동안 Weather API의 해당 Google 지도 콘텐츠를 일시적으로 캐시할 수 있습니다.

표 1.3.1 (캐싱 권한)

이러한 권한은 Google Maps Platform 서비스별 약관의 표 17.2.1에 설명된 권한 외에 추가로 부여됩니다.

Google 지도 콘텐츠	캐싱 기간
날씨 지도 타일	1시간. 이후 고객은 캐시된 Google 지도 콘텐츠를 삭제해야 합니다.

날씨 지도 요청 정보

날씨 지도를 요청하려면 다음 주소로 HTTP GET 요청을 보냅니다.

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

지도 유형

Weather API는 다양한 기본 날씨 모델과 지리적 영역에 해당하는 다양한 날씨 지도 유형을 지원합니다.

• US_PRECIPITATION_CURRENT: 고해상도 미국 강수량 실시간 예보입니다.
• EU_PRECIPITATION_CURRENT: 고해상도 유럽 강수량 실시간 예보입니다.

아래의 커버리지 지도에는 날씨 지도 타일을 사용할 수 있는 지역이 표시되어 있습니다.

타일 좌표 시스템

API는 표준 웹 메르카토르 타일 좌표계를 사용합니다. 지도 및 타일 좌표에 관한 자세한 설명은 로드맵 타일 및 지도 및 타일 좌표를 참고하세요.

이 시스템에서

• zoom: 확대/축소 수준 (0~16)입니다. 확대/축소 수준 0은 하나의 타일 (2⁰ x 2⁰ = 1 타일)에 전체 세계를 나타냅니다. 확대/축소 수준 z는 세계를 2^z x 2^z 타일 그리드로 나눕니다.
• x: 타일의 X 좌표 (열)로, 0 (가장 서쪽)부터 2^zoom - 1 (가장 동쪽)까지입니다.
• y: 타일의 Y 좌표 (행)로, 0 (가장 북쪽)부터 2^zoom - 1 (가장 남쪽)까지입니다.

날씨 지도 표시

Google Maps JavaScript API를 사용하여 웹 애플리케이션에 이러한 타일을 표시하려면 맞춤 google.maps.ImageMapType를 만들면 됩니다.

const weatherMapType = new google.maps.ImageMapType({
  getTileUrl: function(coord, zoom) {
    const mapType = "US_PRECIPITATION_CURRENT";
    return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`;
  },
  tileSize: new google.maps.Size(256, 256),
  maxZoom: 16,
  minZoom: 0,
  name: "Weather"
});

// Overlay on existing map
map.overlayMapTypes.insertAt(0, weatherMapType);

날씨 지도 요청 예

다음 예에서는 뉴올리언스의 미국 강수량 날씨 지도 타일을 요청합니다.

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

대답은 이진수입니다. JSON 래퍼는 ?alt=json과 같은 특정 직렬화 설정에서만 표시됩니다.