지도에 그리기

지도에 객체를 추가하여 점, 선, 영역 또는 객체의 모음을 지정할 수 있습니다. Maps JavaScript API에서는 이러한 객체를 오버레이라고 합니다. 오버레이는 위도/경도 좌표에 연결되어 지도를 드래그하거나 확대/축소하면 움직입니다.

오버레이 유형

Maps JavaScript API의 포토리얼리스틱 3D 지도에서는 프로그래매틱한 방식으로 추가할 수 있는 다양한 유형의 오버레이가 지원됩니다.

  • 지도에서 선은 선분으로 연결된 포인트의 정해진 순서를 나타내는 다중선을 사용하여 표시됩니다.
  • 지도에서 임의의 도형으로 된 영역은 다각형을 사용하여 표시됩니다. 다중선과 마찬가지로 다각형은 위치의 정해진 순서를 나타내지만 다중선과 달리 다각형은 닫힌 영역을 정의합니다.

다중선

다중선은 위치의 정해진 순서에 따라 지도의 선을 표시하는 데 사용됩니다.

다중선 추가

지구 표면에 그려진 빨간색 다중선

<gmp-map-3d center="0,-180,15000000">
  <gmp-polyline-3d altitude-mode="clamp-to-ground" stroke-color="red" stroke-width="10"></gmp-polyline-3d>
</gmp-map-3d>

<script async src="https://maps.googleapis.com/maps/api/js?key=<YOUR_API_KEY>&v=alpha&libraries=maps3d"></script>

<script>
  const polyline = document.querySelector('gmp-polyline-3d');

  customElements.whenDefined(polyline.localName).then(() => {
    polyline.coordinates = [
      { lat: 37.772, lng: -122.214 },
      { lat: 21.291, lng: -157.821 },
      { lat: -18.142, lng: 178.431 },
      { lat: -27.467, lng: 153.027 }
    ];
  });
</script>

다중선 제거

const polyline = document.querySelector('gmp-polyline-3d');
polyline.remove();

가려진 다중선

draws-occluded-segments 속성을 사용하여 가려진 다중선의 가시성을 제어할 수 있습니다.

샌프란시스코 시내를 통과하는 임의의 경로를 그리는 가려진 다중선

<gmp-map-3d heading="25" range="2500" tilt="45" center="37.7905,-122.3989,165">
  <gmp-polyline-3d altitude-mode="relative-to-ground" stroke-color="#1967d2" stroke-width="10" stroke-opacity="0.75"></gmp-polyline-3d>
</gmp-map-3d>

<script async src="https://maps.googleapis.com/maps/api/js?key=<YOUR_API_KEY>&v=alpha&libraries=maps3d"></script>

<script>
  const polyline = document.querySelector('gmp-polyline-3d');

  customElements.whenDefined(polyline.localName).then(() => {
    polyline.coordinates = [
      {lat: 37.80515638571346, lng: -122.4032569467164},
      {lat: 37.80337073509504, lng: -122.4012878349353},
      {lat: 37.79925208843463, lng: -122.3976697250461},
      {lat: 37.7989102378512, lng: -122.3983408725656},
      {lat: 37.79887832784348, lng: -122.3987094864192},
      {lat: 37.79786443410338, lng: -122.4066878788802},
      {lat: 37.79549248916587, lng: -122.4032992702785},
      {lat: 37.78861484290265, lng: -122.4019489189814},
      {lat: 37.78618687561075, lng: -122.398969592545},
      {lat: 37.7892310309145, lng: -122.3951458683092},
      {lat: 37.7916358762409, lng: -122.3981969390652}
    ];
  });
</script>

샘플 보기

다각형

다각형은 지도에서 여러 도형의 영역을 표시하는 데 사용됩니다. 다중선과 마찬가지로 다각형은 위치의 정해진 순서를 나타내지만 다각형은 닫힌 영역을 정의합니다.

간단한 다각형

남부 맨해튼 주변에 있으며, 가장자리가 파란색인 삼각형 모양의 빨간색 다각형

<gmp-map-3d center="40.6842,-74.0019,1000" heading="340" tilt="70">
  <gmp-polygon-3d altitude-mode="clamp-to-ground" fill-color="#ff0000" stroke-color="#0000ff" stroke-width="8" draws-occluded-segments></gmp-polygon-3d>
</gmp-map-3d>

<script async src="https://maps.googleapis.com/maps/api/js?key=<YOUR_API_KEY>&v=alpha&libraries=maps3d"></script>

<script>
  const polygon = document.querySelector('gmp-polygon-3d');

  customElements.whenDefined(polygon.localName).then(() => {
    polygon.outerCoordinates = [
      {lat: 40.7144, lng: -74.0208},
      {lat: 40.6993, lng: -74.019},
      {lat: 40.7035, lng: -74.0004},
      {lat: 40.7144, lng: -74.0208}
    ];
  });
</script>

다각형 제거

const polygon = document.querySelector('gmp-polygon-3d');
polygon.remove();

돌출된 다각형

남부 맨해튼 주변에 있으며, 가장자리가 파란색이고, 고도가 1,000미터인 삼각형 모양의 빨간색 각기둥

<gmp-map-3d center="40.7079,-74.0132,100" heading="30" tilt="55" range="5000">
  <gmp-polygon-3d altitude-mode="relative-to-ground" fill-color="#ff0000" fill-opacity="0.5" stroke-color="#0000ff" stroke-width="8" extruded><gmp-polygon-3d>
</gmp-map-3d>

<script async src="https://maps.googleapis.com/maps/api/js?key=<YOUR_API_KEY>&v=alpha&libraries=maps3d"></script>

<script>
  const polygon = document.querySelector('gmp-polygon-3d');

  customElements.whenDefined(polygon.localName).then(() => {
    polygon.outerCoordinates = [
      {lat: 40.7144, lng: -74.0208, altitude: 1000},
      {lat: 40.6993, lng: -74.019, altitude: 1000},
      {lat: 40.7035, lng: -74.0004, altitude: 1000},
      {lat: 40.7144, lng: -74.0208, altitude: 1000}
    ];
  });
</script>

샘플 보기

내부 구멍이 있는 다각형

남부 맨해튼 주변에 있으며, 가장자리가 파란색이고, 가운데에 구멍이 있는 삼각형 모양의 빨간색 다각형

<gmp-map-3d center="40.7093,-74.0122,10" heading="30" tilt="15" range="5000">
  <gmp-polygon-3d altitude-mode="relative-to-ground" fill-color="#ff0000" fill-opacity="0.5" stroke-color="#0000ff" stroke-width="8" extruded><gmp-polygon-3d>
</gmp-map-3d>

<script async src="https://maps.googleapis.com/maps/api/js?key=<YOUR_API_KEY>&v=alpha&libraries=maps3d"></script>

<script>
  const polygon = document.querySelector('gmp-polygon-3d');

  customElements.whenDefined(polygon.localName).then(() => {
    polygon.outerCoordinates = [
      {lat: 40.7144, lng: -74.0208, altitude: 1000},
      {lat: 40.6993, lng: -74.019, altitude: 1000},
      {lat: 40.7035, lng: -74.0004, altitude: 1000},
      {lat: 40.7144, lng: -74.0208, altitude: 1000}
    ];
    polygon.innerCoordinates = [
      [
        {lat: 40.71, lng: -74.0175, altitude: 1000},
        {lat: 40.703, lng: -74.0165, altitude: 1000},
        {lat: 40.7035, lng: -74.006, altitude: 1000},
        {lat: 40.71, lng: -74.0175, altitude: 1000}
      ]
    ];
  });
</script>