Oturum jetonu, REST çağrılarında bir dizi ilgili mesaj alışverişi dizisi olan oturumu tanımlamak için kullanılan bir veri parçasıdır (UUID). 2D Karolar ve Street View görüntüleriyle ilgili tüm isteklere bir oturum jetonu eklemeniz gerekir.
Bunu, tüm istek URL'lerine eklenen bir session
parametresinin değeri olarak eklersiniz.
Map Tiles API'de oturum jetonu, tanımlı bir dizi görüntüleme seçeneğini temsil eder. Bu, her karo isteğiyle birlikte bir dizi görüntüleme seçeneği iletmeniz gerekmediği anlamına gelir. Aynı oturum jetonunu birden fazla istemcide kullanabilirsiniz.
Oturum jetonu şu anda veriliş zamanından itibaren iki hafta boyunca geçerlidir ancak bu süre değişebilir. İstediğiniz zaman yanıt mesajındaki expiry
alanına bakarak oturum jetonunun geçerlilik süresini kontrol edebilirsiniz.
Oturum jetonu isteği
Oturum jetonu istemek için createSession
uç noktasına aşağıdaki örnekte gösterildiği gibi bir HTTPS POST isteği gönderin. İsteği Content-Type: application/json
başlığıyla göndermeniz gerekir.
curl -X POST -d '{ "mapType": "streetview", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
Zorunlu alanlar
mapType
Temel harita türü. Bu değer aşağıdakilerden biri olabilir:
roadmap
- Standart Google Haritalar, boyalı harita karolarını kullandı.
satellite
- Uydu görüntüleri.
terrain
- Arazi görüntüleri. Harita türü olarak
terrain
seçilirkenlayerRoadmap
katman türünü de eklemeniz gerekir (İsteğe bağlı alanlar bölümünde açıklanmıştır). streetview
- Street View panoramaları. Daha fazla bilgi için Street View Karoları bölümüne bakın.
language
Karolardaki bilgileri görüntülemek için kullanılan dili belirten IETF dil etiketi. Örneğin
en-US
, ABD'de konuşulan İngilizce dilini belirtir.region
Kullanıcının fiziksel konumunu temsil eden Common Yerel Veri Deposu bölge tanımlayıcısı (iki büyük harf). Örneğin,
US
.
İsteğe bağlı alanlar
imageFormat
- Döndürülecek dosya biçimini belirtir. Geçerli değerler
jpeg
veyapng
şeklindedir. JPEG dosyaları şeffaflığı desteklemediğinden yer paylaşımlı karolar için önerilmez.imageFormat
belirtmezseniz öğe için en iyi biçim otomatik olarak seçilir. scale
Harita öğelerinin (yol etiketleri gibi) boyutunu ölçeklendirirken, varsayılan parçanın boyutunu ve kapsama alanını korur. Ölçeğin artırılması haritadaki etiket sayısını da azaltarak karmaşayı azaltır. Aşağıdaki değerler geçerli
scale
değerleridir:scaleFactor1x
: Varsayılandır.scaleFactor2x
: Etiket boyutunu iki katına çıkarır ve küçük özellik etiketlerini kaldırır.scaleFactor4x
: Etiket boyutunu dört katına çıkarır ve küçük özellik etiketlerini kaldırır.
Aşağıdaki örneklerde, harita öğelerini ölçeklendirmenin etkileri gösterilmektedir.
Ölçek Faktörü 1x | Ölçek Faktörü 2x |
---|---|
highDpi
- Yüksek çözünürlüklü karoların döndürülüp döndürülmeyeceğini belirtir. Ölçek faktörü artırılırsa karonun boyutunu büyütmek için
highDpi
kullanılır. Normalde ölçek faktörü artırıldığında elde edilen karo aynı boyutta bir resme dönüştürülerek kalite düşer.highDpi
ile elde edilen boyut da artırılarak kalite korunur. DPI, İnç Başına Nokta anlamına gelirken Yüksek DPI, karonun inç başına normalden daha fazla nokta kullanılarak oluşturulması anlamına gelir.true
ise x ve y boyutlarının her birindeki piksel sayısı ölçek faktörüyle (yani 2x veya 4x) çarpılır. Karonun kapsama alanı değişmez. Bu parametre yalnızca 2x veya 4x olanscale
değerleriyle çalışır. 1x ölçekli karolar üzerinde etkisi yoktur.
Ölçek Faktörü 1x | Ölçek Faktörü 2x Yüksek DPI |
---|---|
layerTypes
Haritaya eklenen katman türlerini belirten bir değer dizisi. Geçerli değerler şunlardır:
layerRoadmap
- Harita türü olarak
terrain
değerini belirtirseniz zorunlu olur. Ayrıca, isteğe bağlı olaraksatellite
harita türünde de yer paylaşımlı olarak kullanılabilir. Yol haritası karolarına etkisi yoktur. layerStreetview
- Street View'ın etkin olduğu sokakları ve konumları, harita üzerinde mavi dış çizgiler kullanarak gösterir.
layerTraffic
- Mevcut trafik koşullarını gösterir.
styles
Yollar, parklar ve yerleşim alanları gibi harita özelliklerinin görünümünü ve ayrıntı düzeyini belirten bir dizi JSON stili nesne. Stil, standart Google temel haritasını özelleştirmek için kullanılır.
styles
parametresi yalnızca eşleme türüroadmap
olduğunda geçerlidir. Stil söz diziminin tamamı için Stil Referansı bölümüne bakın.overlay
layerTypes
öğesinin ayrı bir bindirme olarak mı yoksa temel görüntülerle mi birleştirileceğini belirten bir boole değeridir.true
olduğunda, temel harita gösterilmez. Herhangi birlayerTypes
tanımlamadıysanız bu değer yoksayılır.
Örneğin, layerRoadmap
katmanına sahip satellite
harita türü isteğinde bulunup overlay
özelliğinin false
olarak ayarlanması, Maps JavaScript API'de (soldaki resim) kullanılan hybrid
harita türüne eşdeğer karolar elde edilmesini sağlar. overlay
ile aynı harita ve katman türlerinin true
olarak ayarlanması, harita yerleşiminin bulunduğu ve uydu görüntülerinin üzerine bindirmek için uygun şekilde stilize edilen (sağdaki resim) şeffaf bir blok elde edilmesini sağlar.
overlay : yanlış |
overlay : doğru |
---|---|
Aşağıdaki JSON, hem gerekli hem de isteğe bağlı alanları içeren tipik bir istek gövdesi örneğidir.
{
"mapType": "satellite",
"language": "en-US",
"region": "us",
"layerTypes": [ "layerRoadmap", "layerStreetview" ],
"overlay": true,
"scale": "scaleFactor1x",
"styles": [
{
"stylers": [
{ "hue": "#00ffe6" },
{ "saturation": -20 }
]
},{
"featureType": "road",
"elementType": "geometry",
"stylers": [
{ "lightness": 100 },
{ "visibility": "simplified" }
]
}
]
}
Bu örnekte, uydu görüntüleriyle birleştirme için uygun bir yer paylaşımı gösterilmektedir. Örnekte hem bir yol haritası hem de sokak görünümü yer paylaşımı bulunmaktadır. Ortaya çıkan harita, ABD'de kullanıldığı şekilde İngilizce dilindeki adlar ve verilerle oluşturulur.
apiOptions
: Uygulanacak ek seçenekleri belirten değerler dizisi.
Desteklenen seçenekler şunlardır:
MCYJ5E517XR2JC
- Yeni harita stilini etkinleştirin. Etkinleştirme dönemi boyunca, bu değer belirtilmediği sürece istekleriniz mevcut stili alır.
Oturum jetonu yanıtı
Aşağıdaki JSON, örnek bir yanıt gövdesidir.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
Aşağıdaki liste, yanıt gövdesindeki alanların tanımlarını içerir.
session
- Tüm Map Tiles API isteklerinize dahil etmeniz gereken bir oturum jetonu değeridir.
expiry
- Jetonun süresinin dolacağı süreyi (dönemden bu yana geçen saniye cinsinden) içeren bir dize. Bir oturum jetonu, oluşturulma zamanından itibaren iki hafta boyunca geçerlidir ancak bu politika önceden haber verilmeden değiştirilebilir.
tileWidth
- Karoların piksel cinsinden ölçülen genişliği.
tileHeight
- Karoların piksel cinsinden ölçülen yüksekliği.
imageFormat
- Resim biçimi (
png
veyajpeg
olabilir).