Bu sayfa, Cloud Translation API ile çevrilmiştir.

Map Tiles API ile oturum jetonları kullanma

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Oturum jetonu, bir oturumu (bir dizi ilgili mesaj alışverişi) tanımlamak için REST çağrılarında 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 parametreyi, tüm istek URL'lerine eklenen bir session parametresinin değeri olarak eklersiniz.

Map Tiles API'de oturum jetonu, tanımlanmış bir dizi görüntüleme seçeneğini temsil eder. Bu, her döşeme isteğiyle 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ş tarihinden 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 her zaman 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 Döşemeleri başlıklı makaleyi inceleyin.

language

Döşemelerdeki 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 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'dir. JPEG dosyaları şeffaflığı desteklemediğinden yer paylaşımı kutuları için önerilmez. imageFormat belirtmezseniz kutucuk için en uygun biçim otomatik olarak seçilir.

scale

Varsayılan kutucuğun kutucuk 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 değer.
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çekleme faktörü artırılırsa döşemenin boyutu highDpi kullanılarak artırılır. Normalde, ölçek faktörünü artırmak, sonuçta elde edilen karo görüntüsünü aynı boyutta bir resim haline getirerek büyütür ve bu da kaliteyi düşürür. highDpi ile sonuçtaki boyut da artırılır ve kalite korunur. DPI, inç başına nokta sayısı anlamına gelir. Yüksek DPI, kutunun normalden daha fazla inç başına nokta sayısı 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. Karo kapsam alanı değişmez. Bu parametre yalnızca 2x veya 4x scale değerleriyle çalışır. Bu durum, 1x ölçekli kutuları etkilemez.

Ö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 değerini belirtirseniz zorunludur. satellite harita türü üzerine isteğe bağlı olarak da yerleştirilebilir. Yol haritası kutularını etkilemez.
layerStreetview: Haritada Street View'un etkin olduğu sokakları ve yerleri 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 bir JSON stili nesne 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, satellite harita türüyle layerRoadmap katmanı isteğinde bulunmak ve overlay değerini false olarak ayarlamak, Maps JavaScript API'de kullanılan hybrid harita türüne eşdeğer döşemelerle sonuçlanır (soldaki resim). overlay ayarı true olarak belirlenmiş aynı harita ve katman türleri, uydu görüntüleri üzerine yerleştirilmek üzere uygun şekilde biçimlendirilmiş bir harita yerleşimi içeren şeffaf bir karo ile sonuçlanır (sağdaki resim).

`overlay`: yanlış	`overlay`: true

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 örnek, uydu görüntüleriyle birleştirmeye uygun bir yer paylaşımı sağlar. Örnekte hem yol haritası hem de Street View katmanı yer alıyor. Sonuç olarak elde edilen harita, Amerika Birleşik Devletleri'nde konuşulduğu şekliyle İngilizce 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 Harita Döşemeleri 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şturulma zamanından itibaren iki hafta boyunca geçerlidir ancak bu politika önceden bildirilmeden değişebilir.
tileWidth: Döşemelerin piksel cinsinden genişliği.
tileHeight: Döşemelerin piksel cinsinden yüksekliği.
imageFormat: Resim biçimi (png veya jpeg olabilir).