Coordinates

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

LatLng 클래스

google.maps.LatLng 클래스

LatLng는 지리적 좌표로, 위도와 경도의 한 지점입니다.

  • 위도 범위는 -90도 이상 90도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 [-90, 90] 범위로 잘립니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
  • 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 잘립니다. 예를 들어 값이 -190이면 170으로 변환됩니다. 190이라는 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 둘러싼 사실을 반영한 것입니다.
기본 지도 투영에서는 경도를 지도의 x 좌표와 연결하고 위도를 y 좌표와 연결하지만, 위도 좌표는 항상 먼저, 이어서 경도로 작성됩니다.
LatLng의 좌표는 수정할 수 없습니다. 다른 포인트를 계산하려면 새 포인트를 만들어야 합니다.

LatLng 객체를 허용하는 대부분의 메서드는 LatLngLiteral 객체도 허용하므로 다음은 동일합니다.

 map.setCenter(new google.maps.LatLng(-34, 151));
map.setCenter({lat: -34, lng: 151});

생성자는 LatLngLiteralLatLng 객체도 허용합니다. LatLng 인스턴스가 생성자에 전달되면 사본이 생성됩니다.

생성자에 발생할 수 있는 호출은 다음과 같습니다.

 new google.maps.LatLng(-34, 151);
new google.maps.LatLng(-34, 151, true);
new google.maps.LatLng({lat: -34, lng: 151});
new google.maps.LatLng({lat: -34, lng: 151}, true);
new google.maps.LatLng({lat: -34, lng: 151}, null, true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151), null, true);

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
매개변수:
  • latOrLatLngOrLatLngLiteral: number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap: number|boolean optional
  • noClampNoWrapboolean optional
지리적 지점을 나타내는 LatLng 객체를 만듭니다. 위도는 [-90, 90] 범위 내에서 도 단위로 지정됩니다. 경도는 [-180, 180) 범위 내에서 도 단위로 지정됩니다. 이 범위를 벗어난 값을 사용 설정하려면 noClampNoWraptrue로 설정합니다. 위도 및 경도의 순서를 확인합니다.
equals
equals(other)
매개변수:
반환 값: boolean
비교 함수입니다.
lat
lat()
매개변수: 없음
반환 값: number
위도(도)를 반환합니다.
lng
lng()
매개변수: 없음
반환 값: number
경도(도)를 반환합니다.
toJSON
toJSON()
매개변수: 없음
반환 값: LatLngLiteral
JSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용하기 위한 것입니다.
toString
toString()
매개변수: 없음
반환 값: string
문자열 표현으로 변환합니다.
toUrlValue
toUrlValue([precision])
매개변수:
  • precisionnumber optional
반환 값: string
이 LatLng에 대한 'lat,lng' 형식의 문자열을 반환합니다. 기본적으로 lat/lng 값을 소수점 6자리로 반올림합니다.

LatLngLiteral 인터페이스

google.maps.LatLngLiteral 인터페이스

편의를 위해 LatLng 객체 대신 객체 리터럴이 여러 위치에서 허용됩니다. Maps API에서 이러한 객체를 발견하면 LatLng 객체로 변환됩니다.

예:

 map.setCenter({lat: -34, lng: 151});
new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

기하학 라이브러리에서 LatLng 객체 리터럴이 지원되지 않습니다.

lat
유형: number
위도입니다. 값은 [-90, 90] 범위로 잘립니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
lng
유형: number
경도입니다. 범위 [-180, 180] 이외의 값은 범위 내에 속하도록 잘립니다. 예를 들어 값이 -190이면 170으로 변환됩니다. 190이라는 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 둘러싼 사실을 반영한 것입니다.

LatLngBounds 클래스

google.maps.LatLngBounds 클래스

LatLngBounds 인스턴스는 180도 경도 자오선을 교차하는 좌표를 포함하여 지리적 좌표로 직사각형을 나타냅니다.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
매개변수:
남서쪽과 북동쪽 모서리 지점에서 직사각형을 생성합니다.
contains
contains(latLng)
매개변수:
반환 값: boolean
지정된 lat/lng가 이 경계에 있으면 true를 반환합니다.
equals
equals(other)
매개변수:
반환 값: boolean
이 경계가 지정된 경계와 거의 같으면 true를 반환합니다.
extend
extend(point)
매개변수:
반환 값: LatLngBounds
지정된 점이 포함되도록 이 경계를 확장합니다.
getCenter
getCenter()
매개변수: 없음
반환 값: LatLng
이 LatLngBounds의 중심을 계산합니다.
getNorthEast
getNorthEast()
매개변수: 없음
반환 값: LatLng
이 경계의 북동쪽 모서리를 반환합니다.
getSouthWest
getSouthWest()
매개변수: 없음
반환 값: LatLng
이 경계의 남서쪽 모서리를 반환합니다.
intersects
intersects(other)
매개변수:
반환 값: boolean
이 경계가 다른 경계와 포인트를 공유할 경우 true를 반환합니다.
isEmpty
isEmpty()
매개변수: 없음
반환 값: boolean
경계가 비어 있는지 여부를 반환됩니다.
toJSON
toJSON()
매개변수: 없음
JSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용하기 위한 것입니다.
toSpan
toSpan()
매개변수: 없음
반환 값: LatLng
지정된 지도 경계를 lat/lng 범위로 변환합니다.
toString
toString()
매개변수: 없음
반환 값: string
문자열로 변환합니다.
toUrlValue
toUrlValue([precision])
매개변수:
  • precision: number optional
반환 값: string
이 경계에 대해 "lat_lo,lng_lo,lat_hi,lng_hi" 형식의 문자열을 반환합니다. 여기서 "lo"는 경계 상자의 남서쪽 모서리에 해당합니다.
union
union(other)
매개변수:
반환 값: LatLngBounds
이 범위와 지정된 경계의 합집합이 포함되도록 이 경계를 확장합니다.
MAX_BOUNDS 지구의 최대 경계에 대한 LatLngBounds 이 경계는 전체 지구를 포함합니다.

LatLngBoundsLiteral 인터페이스

google.maps.LatLngBoundsLiteral 인터페이스

객체 리터럴은 API 전체에서 LatLngBounds 객체 대신 허용됩니다. LatLngBounds 객체로 자동 변환됩니다. 모든 south, west, northeast를 설정해야 합니다. 그렇지 않으면 예외가 발생합니다.

east
유형: number
동쪽 경도입니다. [-180, 180] 범위를 벗어난 값은 [-180, 180)으로 잘립니다. 예를 들어 값이 -190이면 170으로 변환됩니다. 190이라는 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 둘러싼 사실을 반영한 것입니다.
north
유형: number
북쪽 위도입니다. 값은 [-90, 90] 범위로 잘립니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
south
유형: number
도 단위의 남쪽 위도입니다. 값은 [-90, 90] 범위로 잘립니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
west
유형: number
서쪽 경도입니다. [-180, 180] 범위를 벗어난 값은 [-180, 180)으로 잘립니다. 예를 들어 값이 -190이면 170으로 변환됩니다. 190이라는 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 둘러싼 사실을 반영한 것입니다.

LatLngAltitude 클래스

google.maps.LatLngAltitude 클래스

LatLngAltitude는 지리적 좌표(위도, 경도, 고도)의 3D 포인트입니다.

  • 위도 범위는 -90도 이상 90도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 [-90, 90] 범위로 잘립니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
  • 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 잘립니다. 예를 들어 값이 -190이면 170으로 변환됩니다. 190이라는 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 둘러싼 사실을 반영한 것입니다.
  • 고도는 미터 단위로 측정됩니다. 양수 값은 지면 높이의 높이를 나타내고 음수 값은 지면 아래 높이를 나타냅니다.

이 클래스는 LatLngAltitudeLiteral를 구현합니다.

이 클래스는 LatLngLiteral를 구현합니다.

altitude
유형: number
고도를 반환합니다.
lat
유형: number
위도를 반환합니다.
lng
유형: number
경도를 반환합니다.
equals
equals(other)
매개변수:
  • otherLatLngAltitude optional 또 다른 LatLngAltitude 객체입니다.
반환 값: boolean 두 객체가 동일한지 여부.
비교 함수입니다.
toJSON
toJSON()
매개변수: 없음
반환 값: LatLngAltitudeLiteral 이 객체의 JSON 표현입니다.

LatLngAltitudeLiteral 인터페이스

google.maps.LatLngAltitudeLiteral 인터페이스

편의를 위해 LatLngAltitude 객체 대신 객체 리터럴이 여러 위치에서 허용됩니다. Maps API에서 이러한 객체를 발견하면 LatLngAltitude 객체로 변환됩니다.

이 인터페이스는 LatLngLiteral를 확장합니다.

altitude
유형: number
기본값: 0
지면 위의 거리 (미터) 음수 값은 지면 아래에 있습니다.
lat
유형: number
위도입니다. 값은 [-90, 90] 범위로 잘립니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
lng
유형: number
경도입니다. 범위 [-180, 180] 이외의 값은 범위 내에 속하도록 잘립니다. 예를 들어 값이 -190이면 170으로 변환됩니다. 190이라는 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 둘러싼 사실을 반영한 것입니다.

Point 클래스

google.maps.Point 클래스

Point
Point(x, y)
매개변수:
  • xnumber
  • ynumber
2차원 평면의 한 점입니다.
x
유형: number
X 좌표
y
유형: number
Y 좌표
equals
equals(other)
매개변수:
반환 값: boolean
두 Point를 비교합니다.
toString
toString()
매개변수: 없음
반환 값: string
이 Point의 문자열 표현을 반환합니다.

Size 클래스

google.maps.Size 클래스

Size
Size(width, height[, widthUnit, heightUnit])
매개변수:
  • width: number
  • height: number
  • widthUnitstring optional
  • heightUnit: string optional
2차원 크기입니다. 여기서 너비는 x축의 거리이고 높이는 y축의 거리입니다.
height
유형: number
Y축의 높이입니다(픽셀 단위).
width
유형: number
X축의 너비입니다(픽셀 단위).
equals
equals(other)
매개변수:
반환 값: boolean
두 Size를 비교합니다.
toString
toString()
매개변수: 없음
반환 값: string
이 Size의 문자열 표현을 반환합니다.

패딩 인터페이스

google.maps.Padding 인터페이스

bottom optional
유형: number optional
하단 패딩(픽셀)입니다.
left optional
유형: number optional
왼쪽 패딩(픽셀)입니다.
right optional
유형: number optional
오른쪽 패딩(픽셀)입니다.
top optional
유형: number optional
상단에 패딩을 지정합니다(픽셀 단위).

CircleLiteral 인터페이스

google.maps.CircleLiteral 인터페이스

원을 나타내는 객체 리터럴입니다.

이 인터페이스는 CircleOptions를 확장합니다.

center
원의 중심입니다.
radius
유형: number
지표면의 반경입니다(미터 단위).
상속됨: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex