Map Tiles API ile oturum jetonları kullanma

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çilirken layerRoadmap 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 veya png ş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 olan scale 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ı olarak satellite 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 bir layerTypes 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 veya jpeg olabilir).