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

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

약관

이 약관은 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은 단일 타일 (20 x 20 = 타일 1개)로 전 세계를 나타냅니다. 확대/축소 수준 z는 전 세계를 2z x 2z 타일의 그리드로 나눕니다.
  • x: 타일의 X 좌표 (열)로, 0 (가장 서쪽)에서 2zoom - 1 (가장 동쪽)까지입니다.
  • y: 타일의 Y 좌표 (행)로, 0 (가장 북쪽)에서 2zoom - 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과 같은 특정 직렬화 설정에서만 표시됩니다.