Map Tiles API ile oturum jetonları kullanma

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

Harita Karoları API'sinde oturum jetonu, tanımlanmış bir görüntüleme seçenekleri grubunu temsil eder. Bu, her karo isteğiyle bir dizi görüntüleme seçeneği göndermeniz gerekmediği anlamına gelir. Aynı oturum jetonunu birden fazla istemcide kullanabilirsiniz. Oturum jetonu şu anda verildiği tarihten itibaren iki hafta boyunca geçerlidir ancak bu durum değişebilir. Yanıt mesajındaki expiry alanına bakarak oturum jetonunun geçerlilik bitiş zamanını dilediğiniz zaman kontrol edebilirsiniz.

Not: 2D karolar ve Street View karoları almak için oturum jetonlarını kullanmanız gerekir ancak 3D karolar için kullanmanız gerekmez.

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 bir 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 karoları.

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ı başlıklı makaleyi inceleyin.

language

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

region

Kullanıcının fiziksel konumunu temsil eden bir Common Locale Data Repository 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 kart için en iyi biçim otomatik olarak seçilir.

scale

Varsayılan karonun karo boyutunu ve kapsam alanını korurken harita öğelerinin (ör. yol etiketleri) boyutunu büyütür. Ölçeği artırmak, haritada yer alan etiket sayısını da azaltarak dağınıklığı azaltır. 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 öğelerinin ölçeklendirilmesinin etkisi gösterilmektedir.

Ölçeklendirme faktörü 1x	Ölçeklendirme 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 artırmak için highDpi kullanılır. Normalde ölçek faktörü artırıldığında, ortaya çıkan karo aynı boyuttaki bir resme büyütülür ve kalite düşer. highDpi ile elde edilen boyut da artırılarak kalite korunur. DPI, inç başına nokta anlamına gelir. Yüksek DPI, karonun normalden daha fazla inç başına 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. Kartın kapsam alanı değişmez. Bu parametre yalnızca 2x veya 4x scale değerleriyle çalışır. 1x ölçekli karolar bu durumdan etkilenmez.

Ö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'u belirtirseniz gereklidir. İsteğe bağlı olarak satellite harita türüne de yerleştirilebilir. Bu durum, yol haritası kartlarını etkilemez.

layerStreetview

Harita üzerinde mavi ana hatlarla Street View'un kullanılabildiği sokakları ve konumları 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 stilinde nesne dizisi. Stil, standart Google ana haritasını özelleştirmek için kullanılır. styles parametresi yalnızca harita türü roadmap ise geçerlidir. Stil söz dizimini tam olarak öğrenmek için Stil Referansı başlıklı makaleyi inceleyin.

overlay

layerTypes değerinin ayrı bir yer paylaşımı olarak mı yoksa temel görüntülerle birleştirilerek mi oluşturulacağını 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ı ve overlay'nin false olarak ayarlandığı bir satellite harita türü isteğinde bulunmak, Maps JavaScript API'de kullanılan hybrid harita türüne eşdeğer karolar (soldaki resim) oluşturur. overlay'nin true olarak ayarlandığı aynı harita ve katman türleri, uydu görüntülerinin üzerine yerleştirilmek üzere uygun şekilde biçimlendirilmiş bir harita yer paylaşımına sahip şeffaf bir karo oluşturur (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 metnine ö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ştirmeye uygun bir yer paylaşımı sağlanmaktadır. Örnekte hem yol haritası hem de Street View yer paylaşımı bulunmaktadır. Sonuç olarak elde edilen harita, ABD'de konuşulan İngilizce dilinde adlar ve verilerle oluşturulur.

apiOptions: Uygulanacak ek seçenekleri belirten bir değer dizisi. Desteklenen seçenekler:

• 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 listede, yanıt gövdesinde bulunan alanların tanımları yer almaktadır.

session

Map Tiles API isteklerinizin tümüne eklemeniz gereken bir oturum jetonu değeri.

expiry

Jetonun süresinin dolacağı zamanı (epoch'tan itibaren saniye cinsinden) içeren bir dize. Oturum jetonu, oluşturulduğu tarihten itibaren iki hafta boyunca geçerlidir ancak bu politika önceden bildirilmeden değiştirilebilir.

tileWidth

Kartların piksel cinsinden ölçülen genişliği.

tileHeight

Kartların piksel cinsinden ölçülen yüksekliği.

imageFormat

Resim biçimi. png veya jpeg olabilir.