Coordinates

LatLng sınıfı

google.maps.LatLng sınıf
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ü

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
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ü

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ı
LatLngAltitudeLiteral, LatLngLiteral
kitaplığını "core"uygular

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ü

google.maps.LatLngAltitudeLiteral interface
extends LatLngLiteral

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ı

google.maps.Point sınıf
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ı

google.maps.Size sınıf
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ü

google.maps.Padding arayüz

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ü

google.maps.CircleLiteral interface
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ı

google.maps.Orientation3D sınıfı
Orientation3DLiteral
kitaplığını uygular "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ü

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
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ı

google.maps.Vector3D sınıfı
Vector3DLiteral
kitaplığını uygular "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ü

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.