Coordinates

LatLng sınıfı

sınıf google.maps.LatLng
kitaplık "core"

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");
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
İki LatLng için karşılaştırma işlevi. Koordinatlar birbirine 1e-9 kadar yakınsa doğru, aksi takdirde yanlış değerini döndürür.
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ü

interface google.maps.LatLngLiteral
extended by DirectionalLocationLiteral, LatLngAltitudeLiteral
implemented by DirectionalLocation, LatLngAltitude

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ı

sınıf google.maps.LatLngBounds
kitaplık "core"

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");
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ü

arayüz google.maps.LatLngBoundsLiteral

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ı

sınıf google.maps.LatLngAltitude LatLngAltitudeLiteral, LatLngLiteral uyguluyor
DirectionalLocation tarafından genişletildi
kitaplık "core"

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.

const {LatLngAltitude} = await google.maps.importLibrary("core");
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
readonly
Tür: number
Rakımı döndürür.
lat
readonly
Tür: number
Enlemi döndürür.
lng
readonly
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ığı.
İki LatLngAltitude için karşılaştırma işlevi. Koordinatlar birbirine 1e-9 kadar yakınsa doğru, aksi takdirde yanlış değerini döndürür.
toJSON
toJSON([key])
Parametreler:
  • key: string optional
Dönüş Değeri: LatLngAltitudeLiteral
Düz bir nesneye dönüştürür.

LatLngAltitudeLiteral arayüzü

interface google.maps.LatLngAltitudeLiteral extends LatLngLiteral
extended by DirectionalLocationLiteral
implemented by DirectionalLocation, LatLngAltitude

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.
altitude
Tür: number
Zemin yüzeyinin üzerindeki mesafe (metre cinsinden). Negatif değer, yer yüzeyinin altını ifade eder.
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.

Point sınıfı

sınıf google.maps.Point
kitaplık "core" 

const {Point} = await google.maps.importLibrary("core");
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:
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ı

sınıf google.maps.Size
kitaplık "core" 

const {Size} = await google.maps.importLibrary("core");
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ü

arayüz google.maps.Padding

bottom
isteğe bağlı
Tür: number optional
Piksel cinsinden alt dolgu.
left
isteğe bağlı
Tür: number optional
Piksel cinsinden sol dolgu.
right
isteğe bağlı
Tür: number optional
Piksel cinsinden sağ dolgu.
top
isteğe bağlı
Tür: number optional
Piksel cinsinden üst dolgu.

CircleLiteral arayüzü

interface google.maps.CircleLiteral extends CircleOptions

Daireyi temsil eden nesne değişmez değeri.
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ı

class google.maps.Orientation3D implements Orientation3DLiteral
library "core"

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.

const {Orientation3D} = await google.maps.importLibrary("core");
Orientation3D
Orientation3D(value)
Parametreler:
heading
readonly
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
readonly
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
readonly
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([key])
Parametreler:
  • key: string optional
Dönüş Değeri: Orientation3DLiteral
Düz bir nesneye dönüştürür.

Orientation3DLiteral arayüzü

arayüz google.maps.Orientation3DLiteral
Orientation3D tarafından uygulandı

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
isteğe bağlı
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
isteğe bağlı
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
isteğe bağlı
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ı

class google.maps.Vector3D implements Vector3DLiteral
library "core"

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.

const {Vector3D} = await google.maps.importLibrary("core");
Vector3D
Vector3D(value)
Parametreler:
x
readonly
Tür: number
Üç boyutlu vektörün X bileşeni.
y
readonly
Tür: number
Üç boyutlu vektörün Y bileşeni.
z
readonly
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([key])
Parametreler:
  • key: string optional
Dönüş Değeri: Vector3DLiteral
Düz bir nesneye dönüştürür.

Vector3DLiteral arayüzü

arayüz google.maps.Vector3DLiteral
Vector3D tarafından uygulandı

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.