Coordinates

LatLng sınıfı

google.maps.LatLng sınıf

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

  • Enlem, -90 ile 90 derece arasında (bu değerler dahil) değişir. Bu aralığın üstündeki veya altındaki değerler [-90, 90] aralığına sabitlenir. 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) değişir. Bu aralığın üstündeki veya altındaki değerler, aralığa sığacak ş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ünyayı çevrelediği gerçeğini yansıtır.
Varsayılan harita projeksiyonu, boylamı haritanın x koordinatıyla ve enlemi y koordinatıyla ilişkilendirse de enlem koordinatı her zaman ilk olarak yazılır ve ardından boylam gelir.
LatLng koordinatlarını değiştiremeyeceğinizi unutmayın. 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ılabilecek 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") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parametreler: 
  • latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap:  number|boolean optional
  • noClampNoWrap:  boolean 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ına dikkat edin.
equals
equals(other)
Parametreler: 
Dönüş Değeri:  boolean
Karşılaştırma işlevi.
lat
lat()
Parametreler:  Yok
Dönüş Değeri:  number
Enlemi derece cinsinden döndürür.
lng
lng()
Parametreler:  Yok
Dönüş Değeri:  number
Boylamı derece cinsinden döndürür.
toJSON
toJSON()
Parametreler:  Yok
Dönüş 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
Dönüş Değeri:  string
Dize temsiline dönüştürür.
toUrlValue
toUrlValue([precision])
Parametreler: 
  • precision:  number optional
Dönüş 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

Nesne değişmez değerleri, birçok yerde kolaylık sağlamak için LatLng nesneleri yerine kabul edilir. Maps API bu nesnelerle karşılaştığında bunları LatLng nesnelerine dönüştürür.

Örnekler:

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

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

lat
Tür:  number
Derece cinsinden enlem. Değerler [-90, 90] aralığına sabitlenir. 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 sığacak ş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ünyayı çevrelediği gerçeğini yansıtır.

LatLngBounds sınıfı

google.maps.LatLngBounds sınıf

LatLngBounds örneği, 180 derece boylam meridyenini kesen bir dikdörtgen de dahil olmak üzere coğrafi koordinatlarda bir dikdörtgeni temsil eder.

const {LatLngBounds} = await google.maps.importLibrary("core") numarasını 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ünya'nın maksimum sınırları için LatLngBounds. Bu sınırlar tüm dünyayı kapsar.
contains
contains(latLng)
Parametreler: 
Dönüş Değeri:  boolean
Belirtilen enlem/boylam bu sınırlar içindeyse true değerini döndürür.
equals
equals(other)
Parametreler: 
Dönüş 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: 
Dönüş Değeri:  LatLngBounds
Bu sınırları, belirtilen noktayı içerecek şekilde genişletir.
getCenter
getCenter()
Parametreler:  Yok
Dönüş Değeri:  LatLng
Bu LatLngBounds'un merkezini hesaplar.
getNorthEast
getNorthEast()
Parametreler:  Yok
Dönüş Değeri:  LatLng
Bu sınırların kuzeydoğu köşesini döndürür.
getSouthWest
getSouthWest()
Parametreler:  Yok
Dönüş Değeri:  LatLng
Bu sınırların güneybatı köşesini döndürür.
intersects
intersects(other)
Parametreler: 
Dönüş Değeri:  boolean
Bu sınır, diğer sınırla herhangi bir noktayı paylaşıyorsa true değerini döndürür.
isEmpty
isEmpty()
Parametreler:  Yok
Dönüş Değeri:  boolean
Sınırlar boşsa döndürür.
toJSON
toJSON()
Parametreler:  Yok
Dönüş 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
Dönüş Değeri:  LatLng
Belirtilen harita sınırlarını enlem/boylam aralığına dönüştürür.
toString
toString()
Parametreler:  Yok
Dönüş Değeri:  string
Dizeye dönüştürür.
toUrlValue
toUrlValue([precision])
Parametreler: 
  • precision:  number optional
Dönüş 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: 
Dönüş Değeri:  LatLngBounds
Bu sınırları, bu ve verilen sınırların birleşimini içerecek şekilde genişletir.

LatLngBoundsLiteral arayüzü

google.maps.LatLngBoundsLiteral arayüz

API genelinde LatLngBounds nesneleri yerine nesne değişmez değerleri 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 bir 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 sığdırı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ünyayı çevrelediği gerçeğini yansıtır.
north
Tür:  number
Derece cinsinden kuzey enlemi. Değerler [-90, 90] aralığına sabitlenir. 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
Derece cinsinden güney enlemi. Değerler [-90, 90] aralığına sabitlenir. 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 sığdırı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ünyayı çevrelediği gerçeğini yansıtır.

LatLngAltitude sınıfı

google.maps.LatLngAltitude sınıf

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

  • Enlem, -90 ile 90 derece arasında (bu değerler dahil) değişir. Bu aralığın üstündeki veya altındaki değerler [-90, 90] aralığına sabitlenir. 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) değişir. Bu aralığın üstündeki veya altındaki değerler, aralığa sığacak ş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ünyayı çevrelediği gerçeğini yansıtır.
  • Rakım metre cinsinden ölçülür. Pozitif değerler zemin seviyesinin üzerindeki yükseklikleri, negatif değerler ise zemin yüzeyinin altındaki yükseklikleri gösterir.

Bu sınıf, LatLngAltitudeLiteral'yi uygular.

Bu sınıf, LatLngLiteral'yi uygular.

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

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parametreler: 
  • value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Başlatma değeri.
  • noClampNoWrap:  boolean optional [-90, 90] aralığında geçerli enlem değerleri veya [-180, 180] aralığında geçerli boylam değerleri olmasalar bile başlatma değerlerinin korunup korunmayacağı. Varsayılan değer false olup enlem sıkıştırmayı ve boylam sarmayı etkinleştirir.
altitude
Tür:  number
Rakımı 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öndürülen Değer:  LatLngAltitudeLiteral Bu nesnenin JSON gösterimi.

LatLngAltitudeLiteral arayüzü

google.maps.LatLngAltitudeLiteral arayüz

Nesne değişmez değerleri, birçok yerde kolaylık sağlamak için LatLngAltitude nesneleri yerine kabul edilir. Maps API bu nesnelerle karşılaştığında bunları LatLngAltitude nesnelerine dönüştürür.

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

lat
Tür:  number
Derece cinsinden enlem. Değerler [-90, 90] aralığına sabitlenir. 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 sığacak ş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ünyayı çevrelediği gerçeğini yansıtır.
altitude optional
Tür:  number optional
Varsayılan: 0
Zemin yüzeyinin üzerindeki mesafe (metre cinsinden). Negatif değer, yer yüzeyinin altını ifade eder.

Point sınıfı

google.maps.Point sınıf

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

Point
Point(x, y)
Parametreler: 
  • x:  number
  • y:  number
İki boyutlu düzlemdeki bir nokta.
x
Tür:  number
X koordinatı
y
Tür:  number
Y koordinatı
equals
equals(other)
Parametreler: 
  • other:  Point optional
Dönüş Değeri:  boolean
İki noktayı karşılaştırır.
toString
toString()
Parametreler:  Yok
Dönüş Değeri:  string
Bu noktanın dize temsilini döndürür.

Beden sınıfı

google.maps.Size sınıf

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

Size
Size(width, height[, widthUnit, heightUnit])
Parametreler: 
  • width:  number
  • height:  number
  • widthUnit:  string optional
  • heightUnit:  string optional
Genişliğin x eksenindeki mesafe, yüksekliğin ise y eksenindeki mesafe olduğu iki boyutlu boyut.
height
Tür:  number
Y ekseni boyunca piksel cinsinden yükseklik.
width
Tür:  number
X ekseni boyunca piksel cinsinden genişlik.
equals
equals(other)
Parametreler: 
  • other:  Size optional
Dönüş Değeri:  boolean
İki boyutu karşılaştırır.
toString
toString()
Parametreler:  Yok
Dönüş Değeri:  string
Bu Size'ın dize temsilini döndürür.

Dolgu arayüzü

google.maps.Padding arayüz

bottom optional
Tür:  number optional
Piksel cinsinden alt dolgu.
left optional
Tür:  number optional
Piksel cinsinden sol dolgu.
right optional
Tür:  number optional
Piksel cinsinden sağ dolgu.
top optional
Tür:  number optional
Piksel cinsinden üst dolgu.

CircleLiteral arayüzü

google.maps.CircleLiteral arayüz

Daireyi temsil eden nesne değişmez değeri.

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

center
Dairenin merkezi.
radius
Tür:  number
Dünya yüzeyinde metre cinsinden yarıçap.
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 dönüş boyunca standart matematiksel dönüşüm işlemleri için kullanılan üç boyutlu bir vektördür.

  • Yön, [0, 360) derece aralığında bir açıdır.
  • Eğim, [0, 360) derece aralığında bir açıdır.
  • Yana yatma, [0, 360) derece aralığında bir açıdır.

Bu sınıf, Orientation3DLiteral'yi uygular.

const {Orientation3D} = await google.maps.importLibrary("core") numarasını 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 dik) etrafında dönüş. 0 değeri (varsayılan) Kuzey'e eşittir. Pozitif dönüş, z ekseni etrafında saat yönündedir ve 0 ile 360 arasında derece cinsinden belirtilir. Bu aralığın üstündeki veya altındaki değerler, aralığa sığacak ş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önüş. Pozitif dönüş, y ekseni etrafında saat yönündedir ve 0 ile 360 arasında derece cinsinden belirtilir. Bu aralığın üstündeki veya altındaki değerler, aralığa sığacak ş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önüş. Pozitif dönüş, x ekseni etrafında saat yönündedir ve 0 ile 360 arasında derece cinsinden belirtilir. Bu aralığın üstündeki veya altındaki değerler, aralığa sığacak ş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
Dönüş Değeri:  Orientation3DLiteral
JSON gösterimine dönüştürür. Bu işlev, JSON.stringify aracılığıyla kullanılmak üzere tasarlanmıştır.

Orientation3DLiteral arayüzü

google.maps.Orientation3DLiteral arayüz

Nesne değişmez değerleri, birçok yerde kolaylık sağlamak için Orientation3D nesneleri yerine kabul edilir. Maps API bu nesnelerle karşılaştığında bunları Orientation3D nesnelerine dönüştürür.

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

Vector3D sınıfı

google.maps.Vector3D sınıf

Vector3D, üç boyutlu 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 bir reel sayıdır.
  • y bir reel sayıdır.
  • z bir reel sayıdır.

Bu sınıf, Vector3DLiteral'yi uygular.

const {Vector3D} = await google.maps.importLibrary("core") numarasını 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: 
Dönüş Değeri:  boolean
Karşılaştırma işlevi.
toJSON
toJSON()
Parametreler:  Yok
Dönüş Değeri:  Vector3DLiteral
JSON gösterimine dönüştürür. Bu işlev, JSON.stringify aracılığıyla kullanılmak üzere tasarlanmıştır.

Vector3DLiteral arayüzü

google.maps.Vector3DLiteral arayüz

Nesne değişmez değerleri, birçok yerde kolaylık sağlamak için Vector3D nesneleri yerine kabul edilir. Maps API bu nesnelerle karşılaştığında bunları Vector3D nesnelerine dönüştürü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.