Map Tiles API ile oturum jetonları kullanma

Oturum jetonu, REST çağrılarında bir oturumu (bir dizi ilgili mesaj alışverişi) tanımlamak için kullanılan bir veri parçasıdır (UUID). 2D döşemeler ve Street View görüntüleri için yapılan tüm isteklere bir oturum jetonu eklemeniz gerekir. Bu değeri, tüm istek URL'lerine eklenen bir session parametresinin değeri olarak eklersiniz.

Map Tiles API'de oturum jetonu, tanımlanmış bir görüntüleme seçenekleri kümesini temsil eder. Bu sayede, her karo isteğiyle birlikte bir dizi görüntüleme seçeneği iletmeniz gerekmez. Aynı oturum jetonunu birden fazla istemcide kullanabilirsiniz. Oturum jetonları, oluşturuldukları tarihten itibaren iki hafta boyunca geçerlidir ancak bu süre değişebilir. Oturum jetonunun geçerlilik bitiş zamanını, 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 birlikte 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 parçaları.

satellite

Uydu görüntüleri.

terrain

Arazi görüntüleri. Harita türü olarak terrain seçildiğinde 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 Parçaları başlıklı makaleyi inceleyin.

language

Kartlarda bilgileri görüntülemek için kullanılan dili belirten bir IETF dil etiketi. Örneğin, en-US, ABD'de konuşulan İngilizce dilini belirtir.

region

Kullanıcının fiziksel konumunu temsil eden bir 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 veya png'dir. JPEG dosyaları şeffaflığı desteklemediğinden yer paylaşımı kutuları için önerilmez. imageFormat belirtmezseniz karo için en iyi biçim otomatik olarak seçilir.

scale

Varsayılan karonun karo boyutunu ve kapsama alanını korurken harita öğelerinin (ör. yol etiketleri) boyutunu büyütür. Ölçeği büyütmek, haritadaki etiket sayısını da azaltarak karmaşayı önler. Aşağıdaki değerler geçerli scale değerleridir:

• scaleFactor1x: Varsayılan.
• 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 etkisi gösterilmektedir.

Ölçeklendirme Faktörü 1x	Ölçeklendirme Faktörü 2x

highDpi

Yüksek çözünürlüklü döşemelerin döndürülüp döndürülmeyeceğini belirtir. Ölçeklendirme faktörü artırılırsa karonun boyutunu artırmak için highDpi kullanılır. Normalde, ölçeklendirme faktörünü artırmak sonuçtaki döşemeyi aynı boyutta bir resim haline getirerek büyütür ve bu da kaliteyi düşürür. highDpi ile sonuç boyutu da artırılır ve kalite korunur. DPI, inç başına nokta sayısı anlamına gelir ve yüksek DPI, kutunun normalden daha fazla nokta kullanılarak oluşturulduğunu ifade eder. 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. Kutunun kapsama alanı değişmeden kalır. Bu parametre yalnızca 2x veya 4x scale değerleriyle çalışır. 1x ölçekli karolar üzerinde etkisi yoktur.

Ölçeklendirme Faktörü 1x	Ölçeklendirme Faktörü 2x Yüksek DPI

layerTypes

Haritaya eklenen katman türlerini belirten bir değer dizisi. Geçerli değerler:

layerRoadmap

Harita türü olarak terrain'ı belirtirseniz zorunludur. İsteğe bağlı olarak satellite harita türünün üzerine de yerleştirilebilir. Yol haritası kartları üzerinde etkisi yoktur.

layerStreetview

Haritada Street View'un etkinleştirildiği sokakları ve konumları mavi ana hatlarla 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 JSON stil nesneleri dizisi. Stil oluşturma, 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 yer paylaşımı olarak mı oluşturulacağını yoksa temel görüntülerle mi birleştirileceğini belirten bir Boole değeri. true olduğunda temel harita gösterilmez. Herhangi bir layerTypes tanımlamadıysanız bu değer yok sayılır.

Örneğin, layerRoadmap katmanına sahip bir satellite harita türü ve false olarak ayarlanmış overlay isteği, Maps JavaScript API'de kullanılan hybrid harita türüne eşdeğer karolarla sonuçlanır (sol resim). overlay, true olarak ayarlandığında aynı harita ve katman türleri, harita yerleşimi içeren şeffaf bir karo oluşturur. Bu karo, uydu görüntülerinin üzerine yerleştirilmeye uygun şekilde biçimlendirilir (sağdaki resim).

overlay: false	overlay: true

Aşağıdaki JSON, hem zorunlu 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ştirmeye uygun bir yer paylaşımı sunulmaktadır. Örnekte hem yol haritası hem de Street View yer paylaşımı vardır. Sonuç olarak elde edilen harita, Amerika Birleşik Devletleri'nde konuşulan İngilizce dilindeki adlar ve verilerle oluşturulur.

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 almaktadır.

session

Tüm Map Tiles API isteklerinize eklemeniz gereken bir oturum jetonu değeri.

expiry

Jetonun geçerliliğinin sona erdiği zamanı (epoch'tan beri geçen saniye cinsinden) içeren bir dize. Oturum jetonu, oluşturulduğu andan itibaren iki hafta boyunca geçerlidir ancak bu politika önceden haber verilmeksizin değiştirilebilir.

tileWidth

Piksel cinsinden ölçülen karo genişliği.

tileHeight

Döşemelerin piksel cinsinden yüksekliği.

imageFormat

Resim biçimi. png veya jpeg olabilir.