Coordinates

LatLng class

google.maps.LatLng sınıf

LatLng, coğrafi koordinatlardaki bir noktadır: enlem ve boylam.

  • Enlem, -90 ile 90 derece arasında (bu değerler dahil) olmalıdır. Bu aralığın üzerindeki veya altındaki değerler [-90, 90] aralığına ayarlanır. Yani belirtilen değer -90'dan küçükse -90 olarak ayarlanır. Değer 90'dan büyükse 90 olarak ayarlanır.
  • Boylam, -180 ile 180 derece arasında (bu değerler dahil) olmalıdır. Bu aralığın üzerindeki veya altındaki değerler, aralığa girecek şekilde sarmalanır. Örneğin, -190 değeri 170'e dönüştürülür. 190 değeri -170'e dönüştürülür. Bu, boylamların dünyanın etrafını sardığını gösterir.
Varsayılan harita projeksiyonu boylamı haritanın x koordinatıyla, enlemi ise y koordinatıyla ilişkilendirse de enlem koordinatı her zaman önce, ardından boylam koordinatı yazılır.
LatLng koordinatlarını değiştiremezsiniz. Başka bir nokta hesaplamak istiyorsanız yeni bir nokta oluşturmanız gerekir.

LatLng nesnelerini kabul eden çoğu yöntem, LatLngLiteral nesnesini de kabul eder. Bu nedenle, aşağıdakiler eşdeğerdir:

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

Oluşturucu, LatLngLiteral ve LatLng nesnelerini de kabul eder. Oluşturucuya bir LatLng örneği iletilirse kopya oluşturulur.

Oluşturucuya yapılan olası çağrılar aşağıda verilmiştir:

 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") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parametreler: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean optional
Coğrafi bir noktayı temsil eden bir LatLng nesnesi oluşturur. Enlem, [-90, 90] aralığında derece cinsinden belirtilir. Boylam, [-180, 180) aralığında derece cinsinden belirtilir. Bu aralığın dışındaki değerleri etkinleştirmek için noClampNoWrap değerini true olarak ayarlayın. Enlem ve boylamın sıralamasını not edin.
equals
equals(other)
Parametreler: 
İade Değeri:  boolean
Karşılaştırma işlevi.
lat
lat()
Parametreler: Yok
İade Değeri:  number
Enlemi derece cinsinden döndürür.
lng
lng()
Parametreler: Yok
İade Değeri:  number
Boylamı derece cinsinden döndürür.
toJSON
toJSON()
Parametreler: Yok
İade Değeri:  LatLngLiteral
JSON gösterimine dönüştürür. Bu işlevin JSON.stringify üzerinden kullanılması amaçlanmıştır.
toString
toString()
Parametreler: Yok
İade Değeri:  string
Dize gösterimine dönüştürür.
toUrlValue
toUrlValue([precision])
Parametreler: 
  • precisionnumber optional
İade Değeri:  string
Bu LatLng için "lat,lng" biçiminde bir dize döndürür. Enlem/boylam değerlerini varsayılan olarak 6 ondalık basamağa yuvarlarız.

LatLngLiteral arayüzü

google.maps.LatLngLiteral arayüz

Bir kolaylık olarak, birçok yerde LatLng nesneleri yerine nesne değişmezleri kabul edilir. Bunlar, Maps API tarafından karşılaşıldığında LatLng nesnelerine dönüştürülür.

Örnekler:

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

LatLng nesne değişmezleri, Geometry kitaplığında desteklenmez.

lat
Tür:  number
Enlem (derece cinsinden). Değerler [-90, 90] aralığına ayarlanır. Yani belirtilen değer -90'dan küçükse -90 olarak ayarlanır. Değer 90'dan büyükse 90 olarak ayarlanır.
lng
Tür:  number
Derece cinsinden boylam. [-180, 180] aralığının dışındaki değerler, aralığa girecek şekilde sarmalanır. Örneğin, -190 değeri 170'e dönüştürülür. 190 değeri -170'e dönüştürülür. Bu, boylamların dünyanın etrafını sardığını gösterir.

LatLngBounds class

google.maps.LatLngBounds sınıf

Bir LatLngBounds örneği, 180 derece boylam meridyenini geçen bir örnek de dahil olmak üzere coğrafi koordinatlarda bir dikdörtgeni temsil eder.

const {LatLngBounds} = await google.maps.importLibrary("core") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametreler: 
Güneybatı ve kuzeydoğu köşelerindeki noktalardan bir dikdörtgen oluşturur.
MAX_BOUNDS Dünyanın maksimum sınırları için LatLngBounds. Bu sınırlar tüm dünyayı kapsar.
contains
contains(latLng)
Parametreler: 
İade Değeri:  boolean
Belirtilen enlem/boylam bu sınırlarda yer alıyorsa true değerini döndürür.
equals
equals(other)
Parametreler: 
İade Değeri:  boolean
Bu sınırlar, verilen sınırlara yaklaşık olarak eşitse true değerini döndürür.
extend
extend(point)
Parametreler: 
İade Değeri:  LatLngBounds
Bu sınırları, belirtilen noktayı içerecek şekilde genişletir.
getCenter
getCenter()
Parametreler: Yok
İade Değeri:  LatLng
Bu LatLngBounds'un merkezini hesaplar.
getNorthEast
getNorthEast()
Parametreler: Yok
İade Değeri:  LatLng
Bu sınırlamanın kuzeydoğu köşesini döndürür.
getSouthWest
getSouthWest()
Parametreler: Yok
İade Değeri:  LatLng
Bu sınırlamanın güneybatı köşesini döndürür.
intersects
intersects(other)
Parametreler: 
İade Değeri:  boolean
Bu sınırlamalar diğer sınırlamalarla herhangi bir nokta paylaşıyorsa true değerini döndürür.
isEmpty
isEmpty()
Parametreler: Yok
İade Değeri:  boolean
Sınırların boş olup olmadığını döndürür.
toJSON
toJSON()
Parametreler: Yok
İade Değeri:  LatLngBoundsLiteral
JSON gösterimine dönüştürür. Bu işlevin JSON.stringify üzerinden kullanılması amaçlanmıştır.
toSpan
toSpan()
Parametreler: Yok
İade Değeri:  LatLng
Belirtilen harita sınırlarını enlem/boylam aralığına dönüştürür.
toString
toString()
Parametreler: Yok
İade Değeri:  string
Dizeye dönüştürür.
toUrlValue
toUrlValue([precision])
Parametreler: 
  • precisionnumber optional
İade Değeri:  string
Bu sınırlar için "lat_lo,lng_lo,lat_hi,lng_hi" biçiminde bir dize döndürür. Burada "lo", sınırlayıcı kutunun güneybatı köşesine, "hi" ise bu kutunun kuzeydoğu köşesine karşılık gelir.
union
union(other)
Parametreler: