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: 
İade Değeri:  LatLngBounds
Bu sınırları, bu sınırların ve verilen sınırların birleşimini içerecek şekilde genişletir.

LatLngBoundsLiteral interface

google.maps.LatLngBoundsLiteral arayüz

API'nin tamamında LatLngBounds nesneleri yerine nesne değişmezleri kabul edilir. Bunlar otomatik olarak LatLngBounds nesnelerine dönüştürülür. Tüm south, west, north ve east ayarlanmalıdır. Aksi takdirde istisna oluşturulur.

east
Tür:  number
Derece cinsinden doğu boylamı. [-180, 180] aralığının dışındaki değerler [-180, 180) aralığına sarılı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.
north
Tür:  number
Derece cinsinden kuzey enlemi. 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.
south
Tür:  number
Güney enlemi (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.
west
Tür:  number
Derece cinsinden batı boylamı. [-180, 180] aralığının dışındaki değerler [-180, 180) aralığına sarılı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.

LatLngAltitude class

google.maps.LatLngAltitude sınıf

LatLngAltitude, coğrafi koordinatlarda (enlem, boylam ve rakım) 3 boyutlu bir noktadır.

  • 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.
  • Yükseklik metre cinsinden ölçülür. Pozitif değerler yer seviyesinin üzerindeki yükseklikleri, negatif değerler ise yer yüzeyinin altındaki yükseklikleri gösterir.

Bu sınıf LatLngAltitudeLiteral öğesini uygular.

Bu sınıf LatLngLiteral öğesini uygular.

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

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parametreler: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Başlatma değeri.
  • noClampNoWrapboolean optional Başlatma değerlerinin, [-90, 90] aralığında geçerli enlem değerleri veya [-180, 180] aralığında geçerli boylam değerleri olmasa bile korunup korunmayacağı. Varsayılan değer false'dır. Bu değer, enlem sınırlaması ve boylam sarmalamasını etkinleştirir.
altitude
Tür:  number
Yüksekliği döndürür.
lat
Tür:  number
Enlemi döndürür.
lng
Tür:  number
Boylamı döndürür.
equals
equals(other)
Parametreler: 
Döndürülen Değer:  boolean İki nesnenin eşit olup olmadığı.
Karşılaştırma işlevi.
toJSON
toJSON()
Parametreler: Yok
Dönüş Değeri:  LatLngAltitudeLiteral Bu nesnenin JSON gösterimi.

LatLngAltitudeLiteral arayüzü

google.maps.LatLngAltitudeLiteral arayüz

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

Bu arayüz, LatLngLiteral arayüzünü genişletir.

altitude
Tür:  number
Varsayılan: 0
Zemin yüzeyinin üzerindeki mesafe (metre cinsinden). Negatif değer, yer yüzeyinin altında olduğu anlamına gelir.
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.

Point sınıfı

google.maps.Point sınıf

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

Point
Point(x, y)
Parametreler: 
  • xnumber
  • ynumber
İki boyutlu bir düzlemdeki nokta.
x
Tür:  number
X koordinatı
y
Tür:  number
Y koordinatı
equals
equals(other)
Parametreler: 
  • otherPoint optional
İade Değeri:  boolean
İki puanı karşılaştırır
toString
toString()
Parametreler: Yok
İade Değeri:  string
Bu Nokta'nın dize gösterimini döndürür.

Beden sınıfı

google.maps.Size sınıf

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

Size
Size(width, height[, widthUnit, heightUnit])
Parametreler: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
İki boyutlu boyutta genişlik, x eksenindeki mesafeyi; yükseklik ise y eksenindeki mesafeyi ifade eder.
height
Tür:  number
Y ekseni boyunca yükseklik (piksel cinsinden).
width
Tür:  number
X ekseni boyunca genişlik (piksel cinsinden).
equals
equals(other)
Parametreler: 
İade Değeri:  boolean
İki boyutu karşılaştırır.
toString
toString()
Parametreler: Yok
İade Değeri:  string
Bu Boyutun dize gösterimini döndürür.

Dolgu arayüzü

google.maps.Padding arayüz

bottom optional
Tür:  number optional
Alt kısım için piksel cinsinden dolgu.
left optional
Tür:  number optional
Sol için dolgu (piksel cinsinden).
right optional
Tür:  number optional
Sağ dolgu (piksel cinsinden).
top optional
Tür:  number optional
Üst kısımdaki dolgu (piksel cinsinden).

CircleLiteral arayüzü

google.maps.CircleLiteral arayüz

Daireyi temsil eden nesne değişmezi.

Bu arayüz, CircleOptions arayüzünü genişletir.

center
Çemberin merkezi.
radius
Tür:  number
Dünya yüzeyindeki yarıçap (metre cinsinden).
Devralınan: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex

Orientation3D sınıfı

google.maps.Orientation3D sınıf

Orientation3D, yön, eğim ve yuvarlanma boyunca standart matematiksel döndürme dönüşümleri için kullanılan üç boyutlu bir vektördür.

  • heading, [0, 360) derece aralığında bir açıdır.
  • Eğme, [0, 360) derece aralığında bir açıdır.
  • roll, [0, 360) derece aralığında bir açıdır.

Bu sınıf Orientation3DLiteral öğesini uygular.

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

Orientation3D
Orientation3D(value)
Parametreler: 
heading
Tür:  number
Varsayılan: 0
Z ekseni (Dünya yüzeyine normal) etrafında dönme. 0 değeri (varsayılan) Kuzey'e eşittir. Pozitif dönüş, z ekseni etrafında saat yönünde olup 0 ile 360 derece arasında belirtilir. 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. 530 değeri de 170'e dönüştürülür.
roll
Tür:  number
Varsayılan: 0
Y ekseni etrafında döndürme. Pozitif dönüş, y ekseni etrafında saat yönünde olup 0 ile 360 derece arasında belirtilir. 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. 530 değeri de 170'e dönüştürülür.
tilt
Tür:  number
Varsayılan: 0
X ekseni etrafında dönme. Pozitif dönüş, x ekseni etrafında saat yönünde olup 0 ile 360 derece arasında belirtilir. 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. 530 değeri de 170'e dönüştürülür.
equals
equals(other)
Parametreler: 
Döndürülen Değer:  boolean İki nesnenin eşit olup olmadığı.
Karşılaştırma işlevi.
toJSON
toJSON()
Parametreler: Yok
İade Değeri:  Orientation3DLiteral
JSON gösterimine dönüştürür. Bu işlevin JSON.stringify aracılığıyla kullanılması amaçlanmıştır.

Orientation3DLiteral arayüzü

google.maps.Orientation3DLiteral arayüz

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

heading optional
Tür:  number optional
Z ekseni (Dünya yüzeyine normal) etrafında dönme. 0 değeri (varsayılan) Kuzey'e eşittir. Pozitif dönüş, z ekseni etrafında saat yönünde olup 0 ile 360 derece arasında belirtilir.
roll optional
Tür:  number optional
Y ekseni etrafında döndürme. Pozitif dönüş, y ekseni etrafında saat yönünde olup 0 ile 360 derece arasında belirtilir.
tilt optional
Tür:  number optional
X ekseni etrafında dönme. Pozitif dönüş, x ekseni etrafında saat yönünde olup 0 ile 360 derece arasında belirtilir.

Vector3D sınıfı

google.maps.Vector3D sınıf

Vector3D, üç boyutlu bir nesnenin sınırlarını yerel x, y ve z eksenleri boyunca ölçeklendirme gibi standart matematiksel işlemler için kullanılan üç boyutlu bir vektördür.

  • x, reel sayıdır.
  • y, gerçek bir sayıdır.
  • z, reel sayıdır.

Bu sınıf Vector3DLiteral öğesini uygular.

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

Vector3D
Vector3D(value)
Parametreler: 
x
Tür:  number
Üç boyutlu vektörün X bileşeni.
y
Tür:  number
Üç boyutlu vektörün Y bileşeni.
z
Tür:  number
Üç boyutlu vektörün Z bileşeni.
equals
equals(other)
Parametreler: 
İade Değeri:  boolean
Karşılaştırma işlevi.
toJSON
toJSON()
Parametreler: Yok
İade Değeri:  Vector3DLiteral
JSON gösterimine dönüştürür. Bu işlevin JSON.stringify aracılığıyla kullanılması amaçlanmıştır.

Vector3DLiteral arayüzü

google.maps.Vector3DLiteral arayüz

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

x
Tür:  number
Üç boyutlu vektörün X bileşeni.
y
Tür:  number
Üç boyutlu vektörün Y bileşeni.
z
Tür:  number
Üç boyutlu vektörün Z bileşeni.