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). Tüm 2D Parçalar ve Street View görüntüleri için istekler. Bunu, tüm isteklere eklenen bir session parametresinin değeri olarak eklersiniz URL'ler.

Map Tiles API'sinde oturum jetonu, tanımlanmış bir kümeyi temsil eder görüntüleme seçenekleri. Bu, tek seferde bir dizi görüntüleme seçeneğini iletmeniz veya her parça isteğine sahip olur. Aynı oturum jetonunu birden fazla istemcide kullanabilirsiniz. Bir oturum jetonu, şu anda ilgili dokümanın tarihinden itibaren iki hafta boyunca geçerlidir ancak bu süre değişebilir. Bir anahtar kelimenin geçerlilik bitiş zamanını oturum jetonunu kontrol etmek için yanıt mesajındaki expiry alanına bakın.

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

Oturum jetonu isteği

Oturum jetonu istemek için createSession hizmetine HTTPS POST isteği gönderin uç noktasını seçin. İsteği Content-Type: application/json üstbilgisi.

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 harita türü. Bu değer aşağıdakilerden biri olabilir:

roadmap

Standart Google Haritalar, boyalı harita karolarını kullandı.

satellite

Uydu görüntüleri.

terrain

Arazi görüntüleri. Harita türü olarak terrain seçilirken aşağıdakileri de yapmanız gerekir: layerRoadmap katman türünü de içermelidir ( İsteğe bağlı alanlar bölümüne bakın).

streetview

Street View panoramaları. Daha fazla bilgi için bkz. Street View Karoları.

language

IETF dil etiketi dilinin doğru bir şekilde kullanıldığından emin olun. Örneğin, Örneğin en-US, ABD'de konuşulan İngilizce dilini belirtir.

region

CEVAP Ortak Yerel Veri Deposu fiziksel konumu temsil eden bölge tanımlayıcısı (iki büyük harf) temsil eder. Ö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. imageFormat belirtmezseniz kart için en iyi biçim otomatik olarak seçilir.

scale

Harita öğelerinin (ör. yol etiketleri) boyutunu büyütür. karo boyutu ve kapsama alanı. Ölçeği artırmak da haritadaki etiketlerin sayısını azaltarak karmaşayı azaltır. Aşağıdakiler değerler geçerli scale değerleridir:

• scaleFactor1x: Varsayılandır.
• 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 etkileri 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ıldığında karonun boyutunu büyütmek için highDpi kullanılır. Normalde ölçek faktörünü artırmak, sonuç karosunu matrisin bir görüntüsüne bu da kaliteyi düşürür. highDpi ile elde edilen boyut da ve kaliteyi korur. 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 ile çarpılır faktör (yani , 2x veya 4x). Karonun kapsama alanı değişmez. Bu parametre yalnızca 2x veya 4x olan scale değerleriyle çalışır. 1x ölçekli karolar bu durumdan etkilenmez.

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

layerTypes

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

layerRoadmap

Harita türü olarak terrain değerini belirtirseniz zorunlu olur. İsteğe bağlı olarak satellite harita türünde yer alıyor. Yol haritası karolarına etkisi yoktur.

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

Şu öğenin görünüm ve ayrıntı düzeyini belirten JSON stili nesneler dizisi: yollar, parklar ve yerleşim alanları gibi harita özelliklerini kullanabilirsiniz. Stil özelliği, Google'ın standart temel haritasını özelleştirmek. styles parametresi yalnızca şu durumlarda geçerlidir: harita türü roadmap. 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ına sahip bir satellite harita türü ve overlay, false olarak ayarlandı ve hybrid harita türüne eşdeğer karolar sağlıyor Maps JavaScript API'de kullanılıyor (soldaki resim). 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: yanlış	overlay: doğru

Aşağıdaki JSON, hem zorunlu ve isteğe bağlı alanları doldurun.

{
  "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ı görüntüler. Örnekte hem bir yol haritası hem de sokak görünümü yer paylaşımı bulunmaktadır. İlgili içeriği oluşturmak için kullanılan oluşturulan harita, İngilizce dilindeki adlar ve verilerle oluşturulur. Çünkü ABD'de konuşuluyor.

apiOptions: Uygulanacak ek seçenekleri belirten değerler dizisi. Desteklenen seçenekler şunlardır:

• MCYJ5E517XR2JC - yeni harita stiline dokunun. Etkinleştirme dönemi boyunca istekleriniz, stilini kullanmayın.

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'nizin tümüne eklemeniz gereken bir oturum jetonu değeri kabul edersiniz.

expiry

Jetonun geçerlilik süresinin sona erdiği 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 haber verilmeden değiştirilebilir.

tileWidth

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

tileHeight

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

imageFormat

Resim biçimi (png veya jpeg olabilir).