Aralık ayında San Francisco'da düzenlenecek bir sonraki Google Haritalar Platformu Geliştirici Topluluğu Günü'nde bize katılın. Katılmak için hemen başvurun.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Map Tiles API ile oturum jetonları kullanma

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

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 Tiles ve Street View görüntüleri için 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 grubunu 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 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 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 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 (Seçenekler alanı bölümünde açıklanmıştır) eklemeniz gerekir.
streetview: Street View panoraması. 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 İngilizceyi 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ı karoları için önerilmez. imageFormat belirtmezseniz kart 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 artırmak, haritadaki etiket sayısını da azaltarak karmaşayı 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 öğelerini ölçeklendirmenin 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çeklendirme faktörü artırılırsa karonun boyutunu artırmak için highDpi kullanılır. Normalde, ölçeklendirme faktörünün artırılması, elde edilen karoyu aynı boyutta bir resme dönüştürü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. Yüksek DPI, karonun 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çeklendirme faktörüyle (yani 2 kat veya 4 kat) çarpılır. Kartın kapsama alanı değişmez. 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 değerini belirtirseniz zorunludur. İsteğe bağlı olarak satellite harita türünün üzerine de yerleştirilebilir. Yol haritası kartları üzerinde etkisi yoktur.
layerStreetview: Street View'un kullanılabildiği sokakları ve konumları harita üzerinde mavi çizgilerle 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, 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üyle 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ğinde bulunmak, Maps JavaScript API'de kullanılan hybrid harita türüne eşdeğer karolarla sonuçlanır (soldaki 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üsünün ü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ştirilmeye uygun bir yer paylaşımı gösterilmektedir. Örnekte hem yol haritası hem de Street View yer paylaşımı yer almaktadır. Sonuçta elde edilen harita, ABD'de 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 süresinin dolduğu zamanı (epoch'tan itibaren 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: Karoların piksel cinsinden genişliği.
tileHeight: Piksel cinsinden ölçülen karo yüksekliği.
imageFormat: Resim biçimi. png veya jpeg olabilir.