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

LatLng 객체 리터럴은 Geometry 라이브러리에서 지원되지 않습니다.
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 객체 대신 허용됩니다. 이러한 객체는 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)
매개변수: 
  • other:  Point optional
반환 값:  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축의 너비입니다(픽셀 단위).