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(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])
매개변수: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|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 객체 리터럴은 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()
매개변수:  없음
반환 값: