Oturum jetonu, bir oturumu (ilgili mesaj alışverişlerinden oluşan bir dizi) tanımlamak için REST çağrılarında kullanılan bir veri parçasıdır (UUID). 2D Karo 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 görüntüleme seçeneği kümesini temsil eder. Bu, her parça isteğiyle bir dizi görüntüleme seçeneği iletmeniz gerekmediği anlamına gelir. Aynı oturum jetonunu, birden fazla istemcide kullanabilirsiniz.
Bir oturum jetonu, şu anda verildiği tarihten itibaren iki hafta boyunca geçerlidir ancak bu durum değişebilir. Bir oturum jetonunun geçerlilik süresini istediğiniz zaman yanıt mesajındaki expiry
alanına bakarak kontrol edebilirsiniz.
Oturum jetonu isteği
Oturum jetonu istemek için, aşağıdaki örnekte gösterildiği gibi createSession
uç noktasına 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 haritanın türü. Bu değer aşağıdakilerden biri olabilir:
roadmap
- Standart Google Haritalar boyalı harita desenleri.
satellite
- Uydu görüntüleri.
terrain
- Arazi görüntüleri. Harita türü olarak
terrain
seçerkenlayerRoadmap
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 İngilizceyi belirtir.region
Kullanıcının fiziksel konumunu temsil eden Ortak 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
değerleridir. JPEG dosyaları şeffaflığı desteklemediğinden yer paylaşımlı karolar için önerilmez. BirimageFormat
belirtmezseniz blok için en iyi biçim otomatik olarak seçilir. scale
Harita öğelerinin (yol etiketleri gibi) boyutunu ölçeklendirirken varsayılan karo boyutunu ve kapsama alanını korur. Ölçeğin artırılması haritadaki etiket sayısını da azaltarak dağınıklığı azaltır. Aşağıdaki değerler geçerli
scale
değerleridir:scaleFactor1x
: Varsayılan değerdir.scaleFactor2x
: Etiket boyutunu iki katına çıkarır ve küçük özellik etiketlerini kaldırır.scaleFactor4x
: Etiket boyutunu dörde katlar ve küçük özellik etiketlerini kaldırır.
Aşağıdaki örneklerde harita öğelerini ölçeklendirmenin etkisi 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ünün artırılması, elde edilen karonun aynı boyutta bir resme dönüşmesine neden olarak kaliteyi düşürür.highDpi
ile ortaya çıkan boyut da büyütülür ve kalite korunur. DPI, İnç Başına Nokta anlamına gelir. Yüksek DPI ise parçanın, inç başına normalden daha fazla nokta kullanılarak oluşturulduğu 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şmeden kalır. Bu parametre yalnızca 2x veya 4xscale
değerleriyle çalışır. 1x ölçek karoları üzerinde bir etkisi yoktur.
Ölçek Faktörü 1x | Ölçek Faktörü 2x Yüksek DPI |
---|---|
layerTypes
Haritaya eklenen katman türlerini belirten bir değerler dizisi. Geçerli değerler şunlardır:
layerRoadmap
- Harita türü olarak
terrain
belirtirseniz gereklidir. Ayrıca, isteğe bağlı olaraksatellite
harita türünün üzerine de yerleştirilebilir. Yol haritası kutuları üzerinde bir etkisi yoktur. layerStreetview
- Haritada mavi anahatlar kullanarak, Street View'ın etkin olduğu sokakları ve konumları gösterir.
layerTraffic
- Mevcut trafik koşullarını gösterir.
styles
Yol, park 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 harita türüroadmap
ise geçerlidir. Stil söz diziminin tamamı için Stil Referansı'na 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.layerTypes
tanımlamadıysanız bu değer yoksayılır.
Örneğin, layerRoadmap
katmanına sahip satellite
harita türü ve overlay
false
olarak ayarlanırsa Maps JavaScript API'de (soldaki resim) kullanılan hybrid
harita türüne eşdeğer karolar elde edilir. overlay
öğesinin true
olarak ayarlandığı aynı harita ve katman türleri, uydu görüntülerinin (sağ resim) üzerinde yer paylaşımı için uygun şekilde stilize edilmiş harita yer paylaşımına sahip şeffaf bir karoyla sonuçlanır.
overlay : yanlış |
overlay : doğru |
---|---|
Aşağıdaki JSON, hem zorunlu hem de isteğe bağlı alanları içeren tipik bir istek gövdesine örnektir.
{
"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ştirilmeye uygun bir bindirme kullanılmıştır. Örnekte hem yol haritası hem de sokak görünümü yer paylaşımı bulunmaktadır. Ortaya çıkan harita, Amerika Birleşik Devletleri'nde söylendiği gibi İngilizce dilindeki adlar ve verilerle oluşturulur.
apiOptions
: Uygulanacak ek seçenekleri belirten bir değerler dizisi.
Desteklenen seçenekler şunlardır:
MCYJ5E517XR2JC
- Yeni harita stilini etkinleştirin. Bu değer belirtilmezse etkinleştirme dönemi boyunca 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 listede, yanıt gövdesindeki alanların tanımları yer alır.
session
- Tüm Map Tiles API isteklerinize eklemeniz gereken bir oturum jetonu değeri.
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 bildirimde bulunulmadan değiştirilebilir.
tileWidth
- Parçaların piksel cinsinden ölçülen genişliğidir.
tileHeight
- Parçaların piksel cinsinden ölçülen yüksekliğidir.
imageFormat
- Resim biçimi (
png
veyajpeg
olabilir).