Map Tiles API ile oturum jetonları kullanma

Oturum jetonu, bir veri parçasıdır ( UUID) REST çağrılarında kullanılan bir tanımlayıcıya session: bir dizi ilgili mesaj dizisinden bahsedeceğiz. 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.

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. Bir imageFormat belirtmezseniz otomatik olarak seçilir.

scale

Harita öğelerinin (ör. yol etiketleri) boyutunu büyütür. karo boyutu ve varsayılan karo kapsama alanı. Ölçeği de artırmak 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, İnç Başına Nokta anlamına gelirken Yüksek DPI, öğe, inç başına normalden daha fazla nokta kullanılarak oluşturulur. 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. Herhangi bir 1x ölçekli bloklar.

Ölçek 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ü üzerine yerleştirilmiş. Yol haritası karolarına etkisi yoktur.

layerStreetview

Street View'ın etkin olduğu sokakları ve konumları tıklayın.

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 şu amaçlarla kullanılır: Google'ın standart temel haritasını özelleştirmek. styles parametresi yalnızca şu durumlarda geçerlidir: harita türü roadmap. Stil söz diziminin tamamı için şuraya bakın: Stil Referansı.

overlay

layerTypes öğesinin gerekip gerekmediğini belirten boole değeridir. veya temel görüntülerle birleştirilerek oluşturulan içeriklerdir. Zaman true, temel harita gösterilmiyor. Henüz layerTypes tanımlamadıysanız bu değer yoksayı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). Aynı overlay içeren harita ve katman türleri true olarak ayarlandığında şeffaf bir karo ortaya çıkar Uydu görüntülerinin üzerine bindirilecek şekilde stilize edilmiş harita yerleşimiyle (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 liste, yanıt gövdesindeki alanların tanımlarını içerir.

session

Map Tiles API'nizin tümüne eklemeniz gereken bir oturum jetonu değeri kabul edersiniz.

expiry

Jetonun yer aldığı zamanı (dönemden bu yana geçen saniye cinsinden) içeren dize sona erecektir. 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).