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 객체 대신 객체 리터럴이 허용됩니다. 이러한 객체는 Maps API에서 발견되면 LatLng 객체로 변환됩니다.

예: 

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

Geometry 라이브러리에서는 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
지정된 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()
매개변수: 없음
반환 값:  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 객체 대신 객체 리터럴이 허용됩니다. 이러한 객체는 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 클래스

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
너비가 x축의 거리이고 높이가 y축의 거리인 2차원 크기입니다.
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