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ç noktanız vardır. İ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
veyapng
şeklindedir. JPEG dosyaları şeffaflığı desteklemediğinden yer paylaşımlı karolar. BirimageFormat
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 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 olanscale
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ı olaraksatellite
harita türünde yer alıyor. 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, 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. Zamantrue
, temel harita gösterilmiyor. HenüzlayerTypes
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 bir 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
veyajpeg
olabilir).