Map Tiles API ile oturum jetonları kullanma

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çerken 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 İ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 veya png değerleridir. JPEG dosyaları şeffaflığı desteklemediğinden yer paylaşımlı karolar için önerilmez. Bir imageFormat 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 4x scale 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ı olarak satellite 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 veya jpeg olabilir).