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});

생성자는 LatLngLiteral 및 LatLng 객체도 허용합니다. 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(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);

const {LatLng} = await google.maps.importLibrary("core")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
매개변수: 
  • latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap:  number|boolean optional
  • noClampNoWrap:  boolean optional
지리적 지점을 나타내는 LatLng 객체를 만듭니다. 위도는 [-90, 90] 범위에서 도 단위로 지정됩니다. 경도는 [-180, 180] 범위에서 도 단위로 지정됩니다. 이 범위를 벗어난 값을 사용 설정하려면 noClampNoWrap를 true로 설정합니다. 위도와 경도의 순서를 확인합니다.
equals
equals(other)
매개변수: 
반환 값:  boolean
비교 함수입니다.
lat
lat()
매개변수: 없음
반환 값:  number
위도(도)를 반환합니다.
lng
lng()
매개변수: 없음
반환 값:  number
경도(도)를 반환합니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  LatLngLiteral
JSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용하기 위한 것입니다.
toString
toString()
매개변수: 없음
반환 값:  string
문자열 표현으로 변환합니다.
toUrlValue
toUrlValue([precision])
매개변수: 
  • precision:  number optional
반환 값:  string
이 LatLng에 대한 'lat,lng' 형식의 문자열을 반환합니다. 기본적으로 lat/lng 값을 소수점 6자리로 반올림합니다.

LatLngLiteral 인터페이스

google.maps.LatLngLiteral 인터페이스

편의상 여러 위치에서 LatLng 객체 대신 객체 리터럴이 허용됩니다. 이 객체는 지도 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도 경도 자오선을 교차하는 좌표를 포함하여 지리적 좌표로 직사각형을 나타냅니다.

const {LatLngBounds} = await google.maps.importLibrary("core")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
매개변수: 
남서쪽과 북동쪽 모서리 지점에서 직사각형을 생성합니다.
MAX_BOUNDS 지구의 최대 경계에 대한 LatLngBounds 이러한 경계는 지구본 전체를 포함합니다.
contains
contains(latLng)
매개변수: 
반환 값:  boolean
지정된 위도/경도가 이 경계에 있으면 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()
매개변수: 없음
반환 값:  LatLngBoundsLiteral
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'는 경계 상자의 남서쪽 모서리에 해당하고 'hi'는 해당 상자의 북동쪽 모서리에 해당합니다.
union
union(other)
매개변수: 
반환 값:  LatLngBounds
이 범위와 지정된 경계의 합집합이 포함되도록 이 경계를 확장합니다.

LatLngBoundsLiteral 인터페이스

google.maps.LatLngBoundsLiteral 인터페이스

API 전체에서 LatLngBounds 객체 대신 객체 리터럴이 허용됩니다. LatLngBounds 객체로 자동 변환됩니다. south, west, north, east를 모두 설정해야 하며, 그러지 않으면 예외가 발생합니다.
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를 구현합니다.

const {LatLngAltitude} = await google.maps.importLibrary("core")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
매개변수: 
  • value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral 초기화 값입니다.
  • noClampNoWrap:  boolean optional 초기화 값이 [-90, 90] 범위의 유효한 위도 값이거나 [-180, 180] 범위의 유효한 경도 값이 아닐지라도 초기화 값을 유지할지 여부입니다. 기본값은 위도 고정 및 경도 래핑을 사용 설정하는 false입니다.
altitude
유형:  number
고도를 반환합니다.
lat
유형:  number
위도를 반환합니다.
lng
유형:  number
경도를 반환합니다.
equals
equals(other)
매개변수: 
  • other:  LatLngAltitude optional 다른 LatLngAltitude 객체입니다.
반환 값:  boolean 두 객체가 동일한지 여부입니다.
비교 함수입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  LatLngAltitudeLiteral 이 객체의 JSON 표현입니다.

LatLngAltitudeLiteral 인터페이스

google.maps.LatLngAltitudeLiteral 인터페이스

편의상 여러 위치에서 LatLngAltitude 객체 대신 객체 리터럴이 허용됩니다. 이 객체는 지도 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 클래스

const {Point} = await google.maps.importLibrary("core")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
Point
Point(x, y)
매개변수: 
  • x:  number
  • y:  number
2차원 평면 위의 한 지점입니다.
x
유형:  number
X 좌표
y
유형:  number
Y 좌표
equals
equals(other)
매개변수: 
반환 값:  boolean
두 Point를 비교합니다.
toString
toString()
매개변수: 없음
반환 값:  string
이 Point의 문자열 표현을 반환합니다.

Size 클래스

google.maps.Size 클래스

const {Size} = await google.maps.importLibrary("core")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
Size
Size(width, height[, widthUnit, heightUnit])
매개변수: 
  • width:  number
  • height:  number
  • widthUnit:  string optional
  • heightUnit:  string optional
2차원 크기입니다. 여기서 너비는 x축 상의 거리이고 높이는 y축 상의 거리입니다.
height
유형:  number
Y축의 높이입니다(픽셀 단위).
width
유형:  number
X축의 너비입니다(픽셀 단위).
equals
equals(other)
매개변수: 
반환 값:  boolean
두 Size를 비교합니다.
toString
toString()
매개변수: 없음
반환 값:  string
이 Size의 문자열 표현을 반환합니다.

Padding 인터페이스

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