Başlarken

Giriş

Haritalar Statik API, bir URL üzerinden HTTP isteğine yanıt olarak bir resim (GIF, PNG veya JPEG) döndürür. Her istek için haritanın konumunu, resmin boyutunu, yakınlaştırma düzeyini, harita türünü ve haritadaki konumlara isteğe bağlı işaretçilerin yerleştirilmesini belirtebilirsiniz. Ayrıca, işaretçilerinizi alfanümerik karakterler kullanarak etiketleyebilirsiniz.

Maps Static API resmi, bir <img> etiketinin src özelliğine veya diğer programlama dillerindeki eşdeğerine yerleştirilir.

Bu dokümanda, Maps Static API URL'lerinin zorunlu biçimi ve kullanılabilen parametreler açıklanmaktadır. Ayrıca, URL'lerinizi belirtmeye ilişkin bazı ipuçları ve püf noktalarına da dikkat çeker.

Başlamadan önce

Bu doküman, web sayfasına veya mobil uygulamaya Maps Static API resimleri eklemek isteyen web sitesi ve mobil geliştiriciler için hazırlanmıştır. API'nin kullanımıyla ilgili bir giriş ve mevcut parametrelerle ilgili referans materyali sağlar.

Maps Static API ile geliştirmeye başlamadan önce kimlik doğrulama şartlarını (API anahtarına ihtiyacınız vardır) ve API kullanımı ve faturalandırma bilgilerini (projenizde faturalandırmayı etkinleştirmeniz gerekir) inceleyin.

URL Parametreleri

Maps Static API URL'si aşağıdaki biçimde olmalıdır:

https://maps.googleapis.com/maps/api/staticmap?parameters

Web sitenize HTTPS üzerinden erişiliyorsa tarayıcı güvenlik uyarılarını önlemek için Haritalar Statik API resimlerini de HTTPS üzerinden yüklemeniz gerekir. İsteklerinizde kullanıcının konumu gibi hassas kullanıcı bilgileri varsa HTTPS'yi kullanmanız da önerilir:

https://maps.googleapis.com/maps/api/staticmap?parameters

HTTP veya HTTPS kullanılıyor olsa da bazı URL parametreleri zorunludur, bazıları ise isteğe bağlıdır. URL'lerde standart olduğu gibi, tüm parametreler "ve" (&) karakteri kullanılarak ayrılır. Parametrelerin listesi ve olası değerleri bu belgede belirtilmiştir.

Maps Static API, harita görüntülerini aşağıdaki URL parametrelerini kullanarak tanımlar:

Konum parametreleri

• center (işaretçiler yoksa zorunludur), haritanın tüm kenarlarından eşit mesafede olacak şekilde haritanın merkezini tanımlar. Bu parametre, bir konumu virgülle ayrılmış {latitude,longitude} çifti (ör. "40.714728,-73.998672") veya dize adresi (ör. "belediye, istanbul, ny") olarak alır. Daha fazla bilgi için Konumlar konusuna bakın.
• zoom (işaretçi yoksa zorunlu) haritanın yakınlaştırma düzeyini tanımlar. Bu değer, haritanın büyütme düzeyini belirler. Bu parametre, istenen bölgenin yakınlaştırma düzeyine karşılık gelen sayısal bir değer alır. Daha fazla bilgi için Yakınlaştırma seviyeleri konusuna bakın.

Harita parametreleri

• size (zorunlu), harita görüntüsünün dikdörtgen boyutlarını tanımlar. Bu parametre, {horizontal_value}x{vertical_value} biçiminde bir dize alır. Örneğin, 500x400 500 piksel genişliğinde ve 400 piksel yüksekliğinde bir harita tanımlar. Genişliği 180 pikselden küçük olan haritalarda küçültülmüş boyutta bir Google logosu gösterilir. Bu parametre, scale parametresinden etkilenir. Nihai çıkış boyutu, boyut ve ölçek değerlerinin çarpımıdır.
• scale (isteğe bağlı), döndürülen piksel sayısını etkiler. scale=2, aynı kapsama alanını ve ayrıntı düzeyini korurken (haritanın içeriği değişmez) scale=1 oranından iki kat daha fazla piksel döndürür. Bu, yüksek çözünürlüklü ekranlar için geliştirirken kullanışlıdır. Varsayılan değer: 1. Kabul edilen değerler: 1 ve 2. Daha fazla bilgi için Ölçek Değerleri bölümüne bakın.
• format (isteğe bağlı) elde edilen resmin biçimini tanımlar. Varsayılan olarak, Maps Static API PNG resimler oluşturur. GIF, JPEG ve PNG türleri dahil olmak üzere çeşitli biçimler kullanılabilir. Hangi biçimi kullanacağınız, resmi nasıl sunmak istediğinize bağlıdır. JPEG genellikle daha fazla sıkıştırma sağlarken GIF ve PNG daha fazla ayrıntı sağlar. Daha fazla bilgi için Resim Biçimleri bölümüne bakın.
• maptype (isteğe bağlı), oluşturulacak harita türünü tanımlar. roadmap, satellite, hybrid ve terrain dahil olmak üzere çeşitli harita türü değerleri vardır. Daha fazla bilgi için Maps Static API Harita Türleri başlıklı makaleyi inceleyin.
• language (isteğe bağlı), harita parçalarında etiketlerin görüntülenmesi için kullanılacak dili tanımlar. Bu parametrenin yalnızca bazı ülke karoları için desteklendiğini unutmayın. İstekte bulunulan dil karo grubu için desteklenmiyorsa söz konusu karo grubu için varsayılan dil kullanılır.
• region (isteğe bağlı), coğrafi-politik hassasiyetlere göre gösterilecek uygun sınırları tanımlar. İki karakterli bir ccTLD ("üst düzey alan") değeri olarak belirtilen bir bölge kodunu kabul eder. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın.

Özellik parametreleri

• map_id (isteğe bağlı) belirli bir haritanın tanımlayıcısını belirtir. Harita kimliği, bir haritayı belirli bir stil veya özellikle ilişkilendirir ve haritayı başlatmak için kullanılan API anahtarıyla aynı projeye ait olmalıdır. Daha fazla bilgi için Harita kimliklerini kullanma başlıklı makaleyi inceleyin.
• markers (isteğe bağlı) Belirtilen konumlarda resme eklenecek bir veya daha fazla işaretçi tanımlar. Bu parametre, | karakteriyle ayrılmış parametreler içeren tek bir işaretçi tanımı alır. Aynı stile sahip oldukları sürece aynı markers parametresine birden fazla işaretçi yerleştirilebilir. markers parametreleri ekleyerek farklı stillerde ek işaretçiler ekleyebilirsiniz. Bir harita için işaretçi sağlarsanız (normalde zorunlu olan) center ve zoom parametrelerini belirtmeniz gerekmediğini unutmayın. Daha fazla bilgi için Maps Static API İşaretleri başlıklı makaleyi inceleyin.
• path (isteğe bağlı), belirtilen konumlarda resim üzerinde yer alacak iki veya daha fazla bağlı noktanın tek yolunu tanımlar. Bu parametre, boru karakteriyle (|) ayrılmış bir nokta tanımı dizesini veya yolun konum beyanında enc: ön ekini kullanan kodlanmış bir çok çizgiyi alır. Ek path parametreleri ekleyerek ek yollar sağlayabilirsiniz. Bir harita için yol sağlarsanız (normalde zorunlu olan) center ve zoom parametrelerini belirtmeniz gerekmediğini unutmayın. Daha fazla bilgi için Haritalar Statik API Yolları başlıklı makaleyi inceleyin.
• visible (isteğe bağlı), haritada görünür kalması gereken bir veya daha fazla konum belirtir. Ancak bu konumlarda işaretçi veya başka göstergeler görüntülenmez. Belirli özelliklerin veya harita konumlarının Maps Static API'de gösterilmesini sağlamak için bu parametreyi kullanın.
• style (isteğe bağlı), haritanın belirli bir özelliğinin (yollar, parklar ve diğer özellikler) sunumunu değiştirmek için özel bir stil tanımlar. Bu parametre, stil uygulanacak özellikleri tanımlayan feature ve element bağımsız değişkenlerini ve seçili özelliklere uygulanacak bir stil işlemleri grubunu alır. Ek style parametreleri ekleyerek birden fazla stil sağlayabilirsiniz. Daha fazla bilgi için stilize haritalar kılavuzunu inceleyin.

Anahtar ve imza parametreleri

• key (zorunlu), Google Cloud Console'da uygulamanızın API kullanımını izlemenize olanak tanır ve Google'ın, gerekirse uygulamanızla ilgili olarak sizinle iletişime geçebilmesini sağlar. Daha fazla bilgi için Haritalar Statik API ile API Anahtarlarını Kullanma başlıklı makaleyi inceleyin.
• signature (önerilir), API anahtarınızı kullanarak istek oluşturan sitelerin bu işlemi yapmaya yetkili olduğunu doğrulamak için kullanılan bir dijital imzadır. Dijital imza içermeyen istekler başarısız olabilir. Daha fazla bilgi için Dijital İmza Kullanma başlıklı makaleyi inceleyin.

URL boyutu kısıtlaması

Maps Static API URL'leri en fazla 16.384 karakterle sınırlıdır. Pratikte, çok sayıda işaretçi ve yol içeren karmaşık haritalar oluşturmadığınız sürece muhtemelen bundan daha uzun URL'lere ihtiyacınız olmaz.

Parametre Kullanımı

Haritalar Statik API'si yalnızca parametrelendirilmiş bir URL'den oluştuğu için kullanımı nispeten kolaydır. Bu bölümde, URL'lerinizi oluşturmak için bu parametrelerin nasıl kullanılacağı açıklanmaktadır.

Konumları belirtme

Haritalar Statik API'si, hem haritayı doğru konuma odaklamak (center parametresini kullanarak) hem de haritadaki konumlara isteğe bağlı yer işaretleri yerleştirmek (markers parametresini kullanarak) için haritadaki konumları tam olarak tanımlayabilmelidir. Maps Static API bu konumları belirtmek için sayılar (enlem ve boylam değerleri) veya dizeler (adresler) kullanır. Bu değerler, coğrafi kodlanmış bir konumu tanımlar.

Bazı parametreler (markers ve path parametreleri gibi) birden fazla konum alır. Bu durumlarda konumlar, düşey çubuk (|) karakteriyle ayrılır.

Enlemler ve boylamlar

Enlem ve boylamlar, virgül ile ayrılmış bir metin dizesinde 6 ondalık basamak hassasiyetine sahip rakamlar kullanılarak tanımlanır. Örneğin, "40.714728,-73.998672" geçerli bir coğrafi kod değeridir. 6 ondalık basamaktan sonraki doğruluk oranı ise yoksayılır.

Boylam değerleri, ilk meridyenin bulunduğu İngiltere'nin Greenwich şehrine olan uzaklığını temel alır. Greenwich 51, 477222 enleminde olduğundan haritayı Greenwich'te merkezlemek için center değerini 51.477222,0 olarak girebiliriz:

Enlem ve boylam değerleri, dünya üzerinde geçerli bir konuma karşılık gelmelidir. Enlemler -90 ile 90 arasında, boylamlar ise -180 ile 180 arasında herhangi bir değer alabilir. Geçersiz bir enlem veya boylam değeri belirtirseniz isteğiniz hatalı istek olarak reddedilir.

Adresler

Çoğu kişi enlem ve boylam değerleriyle konuşmaz. Bunlar addresses kullanılarak konumları belirtir. Bir adresi coğrafi noktaya dönüştürme işlemine coğrafi kodlama adı verilir. Maps Static API hizmeti, geçerli adresler sağlarsanız coğrafi kodlamayı sizin için gerçekleştirebilir.

Enlem/boylam belirtebileceğiniz herhangi bir parametrede bunun yerine adres belirten bir dize belirtebilirsiniz. Google, adresin coğrafi kodunu kodlayacak ve Maps Static API hizmetine işaretçilerin yerleştirilmesi ya da konumları belirtirken kullanılacak bir enlem/boylam değeri sağlayacaktır. Dize URL kodlamalı olmalıdır. Bu nedenle, "Belediye Binası, İstanbul, İstanbul" gibi adresler "Belediye+Binası,İstanbul,İstanbul" şeklinde dönüştürülmelidir.

Adreslerin, sokak adresleri gibi tam konumları, adlandırılmış rotalar gibi çoklu çizgileri veya şehirler, ülkeler ya da milli parklar gibi poligon alanları yansıtabileceğini unutmayın. Çok çizgili ve poligonal sonuçlar için Haritalar Statik API sunucusu, adres merkezi olarak çizginin/alanın orta noktasını kullanır. Bir adresin coğrafi kodlamanın nasıl yapılacağı konusunda şüpheniz varsa bu coğrafi kodlama yardımcı programını kullanarak adresi test edebilirsiniz.

Aşağıdaki örnekte, Berkeley, CA için statik bir harita resmi oluşturulmaktadır:

https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Yakınlaştırma seviyeleri

Google Haritalar'daki haritalar, geçerli görünümün çözünürlüğünü tanımlayan bir tam sayı "yakınlaştırma düzeyi"ne sahiptir. Varsayılan roadmap görünümünde 0 (dünyanın tamamının tek bir haritada görülebildiği en düşük yakınlaştırma seviyesi) ile 21+ (sokaklar ve tek tek binalar) arasında yakınlaştırma seviyeleri kullanılabilir. Mevcut olduğunda bina ana hatları, haritada 17 yakınlaştırma düzeyinde görünür. Bu değer bölgeden bölgeye değişir ve zaman içinde veriler geliştikçe değişebilir.

Google Haritalar, 0 yakınlaştırma düzeyini dünyanın tamamını kapsayacak şekilde ayarlar. Her bir sonraki yakınlaştırma düzeyinde hem yatay hem de dikey boyutlarda hassasiyet iki katına çıkar. Bunun nasıl yapılacağı hakkında daha fazla bilgiyi Google Haritalar JavaScript API belgeleri bölümünde bulabilirsiniz.

Not: Tüm yakınlaştırma seviyeleri, dünyanın her yerinde görünmez. Dünyanın bazı bölgelerindeki veriler diğer bölgelere kıyasla daha ayrıntılı olduğundan yakınlaştırma seviyeleri konuma göre değişir.

Hiçbir harita karosunun bulunmadığı bir yakınlaştırma düzeyi için istek gönderirseniz Maps Static API bunun yerine boş bir resim döndürür.

Aşağıdaki listede, her bir yakınlaştırma düzeyinde görmeyi bekleyebileceğiniz yaklaşık ayrıntı düzeyi gösterilmektedir:

• 1: Dünya
• 5: Karalar/kıta
• 10: Şehir
• 15: Sokaklar
• 20: Binalar

Bu örnekte, aynı center değerinde ancak sırasıyla 12 ve 14 yakınlaştırma düzeylerinde Manhattan'ın iki haritası istenir:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Resim boyutları:

size parametresi, center ile birlikte bir haritanın kapsam alanını tanımlar. Ayrıca, scale değeriyle (varsayılan olarak 1) çarpıldığında haritanın piksel cinsinden çıkış boyutunu da tanımlar.

Bu tabloda, her scale değeri için size parametresinin izin verilen maksimum değerleri gösterilmektedir.

Bu örnekte, 1. yakınlaştırma düzeyinde ekvatordaki dünyanın bir "dilimi" istenir:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Bu örnekte, aynı bölgenin ortasına yerleştirilmiş 100 x 100 piksel boyutunda küçük bir harita istenir. Daha küçük Google logosuna dikkat edin:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Ölçek değerleri

Maps Static API'nin size parametresi bir haritanın boyutunu piksel cinsinden tanımlar. Böylece, size=200x200 içeren bir harita 200 piksele 200 piksel değerinde döndürülür. Genellikle inç başına yaklaşık 100 piksel (ppi) görüntüleyen bir LCD bilgisayar monitöründe 200x200 boyutunda bir harita her boyutu yaklaşık 2 inç olur.

Ancak mobil cihazlarda 300 ppi'den yüksek piksel yoğunluklarına sahip yüksek çözünürlüklü ekranlar giderek daha fazla kullanılmaktadır. Bu ekranlar:

• 200x200 piksel boyutundaki bir resmin boyutunu yalnızca 1,75 cm'ye indirerek etiketleri ve simgeleri okunamayacak kadar küçük hale getirebilir veya
• Okunabilirliği artırmak için resmi ölçeklendirerek (yaklaştırarak) bulanık veya pikselli bir resim elde edebilirsiniz.

Çok küçük	Çok belirsiz

Mobil cihazlar için geliştirme yaparken, yukarıdaki sorunları çözen daha yüksek çözünürlüklü harita resimleri döndürmek amacıyla API'nin scale parametresini kullanabilirsiniz. scale değeri, haritanın kapsam alanı değiştirilmeden, resmin piksel cinsinden gerçek çıktı boyutunu belirlemek için size ile çarpılır. Varsayılan scale değeri 1'dir; kabul edilen değerler 1 ve 2'dir.

Örneğin, 2 olan ölçek değeri, ölçek belirtilmeyen bir istekle aynı harita kapsamı alanını döndürür ancak her boyutta iki kat daha fazla piksel içerir. Bu, yollar ve etiketler için de geçerlidir. Böylece, yüksek çözünürlüklü, küçük ekranlarda ve tarayıcı tarafından ölçeklendirildiğinde okunabilir olurlar.

150x150	150x150&ölçek=2

Bu tür bir resim, CSS kullanılarak yüksekliği ve genişliği ayarlanmış bir img veya div etiketine yerleştirildiğinde masaüstü tarayıcılarda da iyi performans gösterir. Tarayıcı, kalite kaybı olmadan resmi doğru boyuta küçültür.

Bu tabloda üç farklı resim isteği gösterilmektedir.

• İlki, ölçek değeri belirtilmemiş 100x100 boyutunda bir resim içindir. Masaüstünde düzgün şekilde görüntülenir ancak mobil cihazda okunamayacak kadar küçüktür.
• İkinci seçenek, harita boyutunu iki katına çıkarır. Masaüstünde CSS, resmi belirtilen 100x100 img öğesine sığdırır ancak resmi küçülttüğünüzde yollar ve etiketler çok küçük olur. Mobil cihazda resim doğru boyutta ancak yine de yollar ve etiketler okunaklı değil.
• Üçüncü istek, scale=2 içeren 100x100 boyutunda bir harita içindir. Resim, 200 piksel ayrıntıyla döndürülür; masaüstü, orijinal 100x100 isteğinden ayırt edilemeyecek şekilde mükemmel bir şekilde ölçeklendirir. Bununla birlikte, mobil tarayıcı, API'nin döndürdüğü ek çözünürlükden yararlanır.

Resim istekleri
Cihaz	100x100	200x200	100x100&scale=2
Masaüstü (img etiketinde height="100px" ve width="100px" ile)
Yüksek Çözünürlük (simülasyon)

Mobil cihazlar ve yüksek çözünürlüklü ekranlar için geliştirme yapma hakkında daha fazla bilgi edinmek isterseniz aşağıdaki makaleyi okumanızı öneririz:

• Android geliştirici dokümanlarında Birden fazla ekranı destekleme başlıklı makaleyi inceleyin.
• Webkit.org'un Yüksek DPI Web Siteleri geliştirmeyle ilgili önerileri.
• iOS Geliştirici Kitaplığı'ndaki Yüksek Çözünürlüklü Ekranları Destekleme başlıklı makaleyi inceleyin.

Resim biçimleri

Resimler, yaygın web grafik biçimlerinden birkaçında döndürülebilir: GIF, JPEG ve PNG. format parametresi aşağıdaki değerlerden birini alır:

• png8 veya png (varsayılan), 8 bit PNG biçimini belirtir.
• png32, 32 bit PNG biçimini belirtir.
• gif, GIF biçimini belirtir.
• jpg, JPEG sıkıştırma biçimini belirtir.
• jpg-baseline, aşamalı olmayan bir JPEG sıkıştırma biçimini belirtir.

Şu örneklerde, gif ve png biçimlerinde eşlemeler istenir:

  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

jpg ve jpg-baseline genellikle en küçük resim boyutunu sağlar ancak bunu, resmin kalitesini düşürebilecek "kaybeden" sıkıştırma yoluyla yapar. gif, png8 ve png32 kayıpsız sıkıştırma sağlar.

Çoğu JPEG resmi progresiftir. Yani, daha kaba bir resmi daha erken yüklerler ve daha fazla veri geldikçe resim çözünürlüğünü hassaslaştırırlar. Bu sayede resimler web sayfalarına hızlıca yüklenebilir. JPEG'nin şu anda en yaygın kullanım alanı budur. Ancak JPEG'in bazı kullanımları için aşamalı olmayan (temel) resimler gerekir. Bu gibi durumlarda, aşamalı olmayan jpg-baseline biçimini kullanmak isteyebilirsiniz.

Harita türleri

Maps Static API, aşağıda listelenen çeşitli biçimlerde haritalar oluşturur:

• roadmap (varsayılan), normalde Google Haritalar web sitesinde gösterildiği gibi standart bir yol haritası resmi belirtir. maptype değeri belirtilmezse Maps Static API varsayılan olarak roadmap karo sunar.
• satellite bir uydu görüntüsünü belirtir.
• terrain, araziyi ve bitki örtüsünü gösteren fiziksel bir kabartma haritası resmini belirtir.
• hybrid, uydu ve yol haritası görüntüsünün bir birleşimini belirtir. Bu birleşimde, uydu görüntüsünde ana caddelerin ve yer adlarının şeffaf bir katmanı gösterilir.

Bu kod örneğinde yol haritası ile arazi türleri arasındaki farkı görebilirsiniz.

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Karma haritalar, kombinasyon haritası oluşturmak için uydu görüntülerini ve belirgin yol haritası özelliklerini kullanır. Aşağıdaki örnekler uydu ve karma harita türlerini göstermektedir:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Stil özellikleri ayarlanmış haritalar

Kendi stillerinizi uygulayarak standart Google haritasının sunumunu özelleştirin. Stilli haritalar rehberine bakın.

İşaretçiler

markers parametresi, bir dizi konumda bir veya daha fazla işaretçi (harita raptiyeleri) tanımlar. Tek bir markers bildiriminde tanımlanan her işaretçi aynı görsel stili göstermelidir. Farklı stillerde işaretçiler görüntülemek istiyorsanız ayrı stil bilgileri içeren birden fazla markers parametresi sağlamanız gerekir.

markers parametresi, aşağıdaki biçime sahip bir değer atama grubu (işaretçi tanımlayıcısı) alır:

markers=markerStyles|markerLocation1| markerLocation2|... vb.

markerStyles grubu, markers beyanının başında tanımlanır ve dikey çizgi karakteriyle (|) ayrılmış sıfır veya daha fazla stil tanımlayıcısı ile dikey çizgi karakteriyle (|) ayrılmış bir veya daha fazla konum grubundan oluşur.

Hem stil bilgileri hem de konum bilgileri dikey çizgi karakteriyle ayrıldığından, stil bilgileri herhangi bir işaretçi tanımlayıcısında önce görünmelidir. Maps Static API sunucusu işaretçi tanımlayıcıda bir konumla karşılaştığında, diğer tüm işaretçi parametrelerinin de konum olduğu varsayılır.

İşaretçi stilleri

İşaretçi stili tanımlayıcısı grubu, dikey çizgi (|) karakteriyle ayrılmış bir dizi değer atamasıdır. Bu stil tanımlayıcısı, bu işaretçi tanımlayıcısı içindeki işaretçileri görüntülerken kullanılacak görsel özellikleri tanımlar. Bu stil tanımlayıcıları aşağıdaki anahtar/değer atamalarını içerir:

• size: (isteğe bağlı), {tiny, mid, small} grubundan işaretçinin boyutunu belirtir. size parametresi ayarlanmazsa işaretçi varsayılan (normal) boyutunda görünür.

• color: (isteğe bağlı) 24 bitlik bir rengi (ör. color=0xFFFFCC) veya {black, brown, green, purple, yellow, blue, gray, orange, red, white} grubundan önceden tanımlanmış bir rengi belirtir.

  Şeffaflıkların (32 bit onaltılık renk değerleri kullanılarak belirtilir) yollarda desteklenmesine rağmen işaretçilerde desteklenmediğini unutmayın.

• label: (isteğe bağlı) {A-Z, 0-9} kümesinden tek bir büyük harf alfanümerik karakter belirtir. (Büyük harf karakteri şartı, API'nin bu sürümünde yenidir.) Yalnızca varsayılan ve mid boyutunda işaretçilerin alphanumeric-character parametresini gösterebileceğini unutmayın. tiny ve small işaretçileri alfanümerik karakter gösteremez.

İşaretçi ölçeklendirme

İşaretçinin piksel cinsinden gerçek çıkış boyutunu oluşturmak için scale değeri, işaretçi resim boyutuyla çarpılır. Varsayılan ölçek değeri 1'dir; kabul edilen değerler 1, 2 ve 4'tür.

Resimlerdeki piksel boyutu sınırı, ölçeklendirme uygulandıktan sonra uygulanır. Örneğin, işaretçi scale:2 olarak ayarlanmışsa ölçeklendirmeden sonra 4096 pikselden az olacak şekilde küçültüldüğü sürece işaretçi, maksimum boyut olan 4096 pikselden daha büyük olabilir. Daha yüksek çözünürlüklü haritalar görüntülerken işaretçi ölçeklendirmesini harita ölçeklendirmesiyle birlikte kullanın.

İşaretçi konumları

Her işaretçi tanımlayıcısı, işaretçinin haritada nereye yerleştirileceğini tanımlayan bir veya daha fazla konum grubu içermelidir. Bu konumlar enlem/boylam değerleri veya addresses olarak belirtilebilir. Bu konumlar dikey çizgi karakteri (|) kullanılarak ayrılır.

Not: İşaretçi konumlarını, kullanıcı tarafından okunabilen adres dizeleri veya çoklu çizgiler gibi coğrafi kodlama gerektiren bir yöntem kullanarak belirtmeyi seçerseniz istek en fazla 15 işaretçiyle sınırlıdır. Bu sınır yalnızca coğrafi kodlama gerektiren işaretçi konumları için geçerlidir. Enlem/boylam koordinatlarıyla belirtilen işaretçi konumları için geçerli değildir.

Konum parametreleri, işaretçinin haritadaki konumunu tanımlar. Konum haritanın dışındaysa center ve zoom parametreleri sağlandığı takdirde bu işaretçi oluşturulan resimde görünmez. Bununla birlikte, bu parametreler sağlanmazsa Haritalar Statik API sunucusu otomatik olarak sağlanan işaretçileri içeren bir resim oluşturur. (Dahili yerleşim konusuna bakın.)

Burada örnek bir işaretçi beyanı gösterilmektedir. Bir stil grubu ve üç konum tanımladığımızı unutmayın:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Farklı stillerde işaretçiler tanımlamak için birden fazla markers parametresi sağlamamız gerekir. Bu markers parametre grubu üç işaretçi tanımlar: 62.107733, -145.5419 koordinatlarında "S" etiketli bir mavi işaretçi, "Delta Junction, AK" konumunda küçük bir yeşil işaretçi ve "Tok, AK" konumunda "C" etiketli orta boy bir sarı işaretçi. Bu işaretçiler aşağıdaki örnekte gösterilmiştir:

https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Özel simgeler

Google'ın işaretçi simgelerini kullanmak yerine kendi özel simgelerinizi kullanabilirsiniz. Özel simgeler, markers parametresindeki icon açıklayıcısı kullanılarak belirtilir. Örneğin:

markers=icon:URLofIcon|markerLocation

icon değerini bir URL kullanarak belirtin (URL kodlamalı olmalıdır). https://goo.gl gibi URL kısaltma hizmetleri tarafından oluşturulan URL'leri kullanabilirsiniz. URL kısaltma hizmetlerinin çoğu, URL'leri otomatik olarak kodlama avantajına sahiptir.

Özel simge için bir sabitleme noktası belirtebilirsiniz. Sabitleme noktası, simgenin belirtilen markers konumlarına göre nasıl yerleştirileceğini belirler. Varsayılan olarak özel bir simgesinin ankraj noktası, simge resminin alt ortasıdır. icon ile birlikte anchor açıklayıcıyı kullanarak farklı bir sabitleme noktası belirtebilirsiniz. anchor öğesini, simgenin x,y noktası (ör. 10,5) veya şu değerlerden birini kullanarak önceden tanımlanmış bir hizalama olarak ayarlayın: top, bottom, left, right, center, topleft, topright, bottomleft veya bottomright. Örneğin:

markers=anchor:bottomright|icon:URLofIcon|markerLocation1|markerLocation2

İstekte her biri benzersiz olmak üzere en fazla beş özel simge kullanabilirsiniz. Bu sınırlama, haritanızda yalnızca 5 işaretli konumla sınırlı olduğunuz anlamına gelmez. Her benzersiz simge, haritanızda birden fazla markers konumuyla birlikte kullanılabilir.

Simge biçimi:

• Simge resimleri PNG, JPEG veya GIF biçiminde olabilir ancak PNG önerilir.
• Simgeler en fazla 4.096 piksel olabilir (kare resimler için 64x64).

Özel simge örnekleri

1. örnek, özel simgeler oluşturur ve simgelerin konumunu sabitleyiciler kullanarak belirler.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY
&signature=YOUR_SIGNATURE

2. örnek, 1. örnekle aynı özel simgeleri oluşturur ancak simge konumlarını sabitleyiciler kullanarak ayarlamaz. Bunun yerine, varsayılan olarak alt ortada olan sabitleyiciyi kullanır.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Maps Static API yolları

path parametresi, harita resmine yerleştirilecek bir yol ile birbirine bağlı bir veya daha fazla konum grubunu tanımlar. path parametresi, aşağıdaki biçime sahip bir değer atama grubu (yol tanımlayıcısı) alır:

path=pathStyles|pathLocation1|pathLocation2|... vb.

Her iki yol noktasının da boru karakteri (|) kullanılarak birbirinden ayrıldığını unutmayın. Hem stil bilgileri hem de nokta bilgileri boru karakteriyle ayrıldığından, stil bilgileri herhangi bir yol tanımlayıcısı içinde ilk olarak görünmelidir. Maps Static API sunucusu yol tanımlayıcıda bir konumla karşılaştığında, diğer tüm yol parametrelerinin de konum olduğu varsayılır.

Yol stilleri

Yol stili tanımlayıcısı grubu, dikey çizgi (|) karakteriyle ayrılmış bir dizi değer atamasıdır. Bu stil açıklayıcı, yolu görüntülerken kullanılacak görsel özellikleri tanımlar. Bu stil tanımlayıcıları aşağıdaki anahtar/değer atamalarını içerir:

• weight: (isteğe bağlı) yolun kalınlığını piksel cinsinden belirtir. weight parametresi ayarlanmazsa yol varsayılan kalınlığında (5 piksel) görünür.

• color: (isteğe bağlı), rengi 24 bit (örnek: color=0xFFFFCC) veya 32 bit onaltılık değer (örnek: color=0xFFFFCCFF) olarak veya {black, brown, green, purple, yellow, blue, gray, orange, red, white} grubu içinden belirtir.

  32 bitlik bir onaltılı değer belirtildiğinde son iki karakter 8 bitlik alfa şeffaflık değerini belirtir. Bu değer, 00 (tamamen şeffaf) ile FF (tamamen opak) arasında değişir. Şeffaflıkların yollarda desteklendiğini ancak işaretçiler için desteklenmediğini unutmayın.

• fillcolor: (isteğe bağlı), hem yolun bir poligonal alanı işaret ettiğini hem de bu alan içinde bindirme olarak kullanılacak dolgu rengini belirtir. Aşağıdaki konum grubunun "kapalı" bir döngü olması gerekmez; Haritalar Statik API sunucusu, ilk ve son noktaları otomatik olarak birleştirir. Ancak, aynı başlangıç ve bitiş konumunu belirtmediğiniz sürece, dolu alanın dışındaki çizgilerin kapatılmayacağını unutmayın.
• geodesic: (isteğe bağlı), istenen yolun, dünyanın eğriliğini takip eden jeodezik bir çizgi olarak yorumlanması gerektiğini belirtir. Yanlış olduğunda yol, ekran alanında düz bir çizgi olarak oluşturulur. Varsayılan değer yanlıştır.

Bazı örnek yol tanımları:

• İnce mavi çizgi, %50 opaklık: path=color:0x0000ff80|weight:1
• Katı kırmızı çizgi: path=color:0xff0000ff|weight:5
• Kalın düz beyaz çizgi: path=color:0xffffffff|weight:10

Bu yol stilleri isteğe bağlıdır. Varsayılan özellikler kullanılmasını istiyorsanız yol özelliklerini tanımlamayı atlayabilirsiniz. Bu durumda, yol tanımlayıcının ilk "argümanını" ilk tanımlanan nokta (konum) yerine oluşturur.

Yol noktaları

Bir yol çizmek için path parametresine iki veya daha fazla nokta da iletilmelidir. Daha sonra Maps Static API bu noktalar boyunca yolu belirtilen sırayla bağlar. Her bir pathPoint, pathDescriptor içinde | (dikey çizgi) karakteriyle ayrılmış olarak belirtilir.

Aşağıdaki örnekte Union Square NY'den Times Square, NY'ye varsayılan% 50 opaklığa sahip mavi bir yol tanımlanmaktadır.

path parametresinin özellikleri şunlardır:

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

Aşağıdaki örnekte, %100 opaklığa sahip sabit kırmızı bir çizgi yerine aynı yol tanımlanmaktadır:

Bu path parametresinin özellikleri şunlardır:

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

Aşağıdaki örnekte, Manhattan'da bir poligon alanı tanımlanmaktadır. Bu alanda, konum olarak bir dizi kavşak iletilmektedir:

Bu path parametresinin özellikleri:

path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\
8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\
Park+Ave+%26+34th+St,New+York,NY,NY

Yolun görünmez, poligonal alanın ise% 15 opaklık değerine sahip olacak şekilde ayarlandığını unutmayın.

Kodlanmış çoklu çizgiler

Bir dizi konum yerine, path öğesinin konum beyanında enc: ön ekini kullanarak bir yolu kodlanmış çoklu çizgi olarak tanımlayabilirsiniz.

Aşağıdaki örnekte, BC, Dawson Creek'ten AK, Delta Junction'a kadar olan Alaska Highway'nin rotası kodlanmış bir çok çizgiyle gösterilmektedir:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=59.900503,-135.478011&zoom=4
&path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU%7D%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA%7Df%5BroaAynd@%7CvXxiAt%7BZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k%7Bg@i%60%5Do%7CF%7DvXaj%5Ch%60%5Dovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh%60%5Dv%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez%5C_%7BKm_%60@~re@ew%5ErcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr%7BZlwBrvdAmtHrmT%7BrOt%7BZz%7DE%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@%60%60NrfQpcHrb%5Ek%7CDh_z@nwB%7Ckb@a%7BR%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY%7Dt%5Dhuf@e%7CFria@o%7DGfezAkdW%7C%7D%5BocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C%60l@uoJrvdAgq@fppAsjGhg%60@%7ChQpg%7BAi_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C%7D%5Bmv%60@t_NitSfjp@c%7DMhg%60@sbChyYq%7De@rwg@atFff%7D@ghN~zKybk@fl%7DA%7DcPftcAite@tmT__Lha@u~DrfQi%7DMhkSqyWivIumCria@ciO_tHifm@fl%7DA%7Brc@fbjAqvg@rrqAcjCf%7Ci@mqJtb%5Es%7C@fbjA%7BwDfs%60BmvEfqs@umWt_Nwn%5Epen@qiBr%60xAcvMr%7BZidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Standart yollarda olduğu gibi, kodlanmış çoklu çizgi yolları da path parametresine bir fillcolor bağımsız değişkeni iletilirse poligonal alanları da belirleyebilir.

Aşağıdaki örnekte, New York, Brooklyn için poligonal bir alan gösterilmektedir:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:%7DzswFtikbMjJzZ%7CRdPfZ%7DDxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz%40bIx%7BA%7CPfYlvApz%40bl%40tcAdTpGpVwQtX%7Di%40%7CGen%40lCeAda%40bjA%60q%40v%7D%40rfAbjA%7CEwBpbAd_%40he%40hDbu%40uIzWcWtZoTdImTdIwu%40tDaOXw_%40fc%40st%40~VgQ%7C%5BuPzNtA%60LlEvHiYyLs%5EnPhCpG%7DSzCNwHpz%40cEvXg%40bWdG%60%5DlL~MdTmEnCwJ%5BiJhOae%40nCm%5B%60Aq%5DqE_pAaNiyBuDurAuB%7D%7DAy%60%40%7CEKv_%40%3F%7C%5BqGji%40lAhYyH%60%40Xiw%40tBerAs%40q%5DjHohAYkSmW%3FaNoaAbR%7DLnPqNtMtIbRyRuDef%40eT_z%40mW_Nm%7CB~j%40zC~hAyUyJ_U%7BZ%3F%3FcPvg%40%7Ds%40sHsc%40_z%40cj%40kp%40YePoNyYyb%40_iAyb%40gBw%5EbOokArcA%7DGwJuzBre%40i%5Ctf%40sZnd%40oElb%40hStW%7B%5Dvv%40%3F%3Fkz%40~vAcj%40zKa%60Atf%40uQj_Aee%40pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Görüntü alanları

Resimler, visible parametresini kullanıp görünür konumları belirterek bir görünüm belirtebilir. visible parametresi, Maps Static API hizmetine mevcut konumların görünür kalacağı şekilde bir harita oluşturmasını söyler. (Bu parametre, görünür bir bölge tanımlamak için mevcut işaretçiler veya yollarla da birleştirilebilir.) Görüntü alanını bu şekilde tanımlamak, tam bir yakınlaştırma düzeyi belirtme ihtiyacını ortadan kaldırır.

Aşağıdaki örnekte, Massachusetts, Cambridge'deki MIT ve Harvard Square'ı içeren, Massachusetts, Boston merkezli bir harita istenir:

https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Haritanın dolaylı olarak yerleştirilmesi

Normalde, oluşturulan haritanızın konumunu ve yakınlaştırma düzeyini tanımlamak için center ve zoom URL parametrelerini belirtmeniz gerekir. Ancak markers, path veya visible parametrelerini sağlarsanız bu öğelerin konumunun değerlendirilmesine göre Maps Static API'nin doğru merkezi ve yakınlaştırma düzeyini dolaylı olarak belirlemesine izin verebilirsiniz.

İki veya daha fazla öğe sağlanırsa Maps Static API, uygun bir merkez ve yakınlaştırma düzeyi belirler ve içerdiği öğeler için geniş marjlar sağlar. Bu örnekte, San Francisco, Oakland ve San Jose, CA'yı içeren bir harita gösterilmektedir:

https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Daha büyük resim boyutları

640 x 640 pikselden (veya ölçek değeri 2 olan 1280 x 1280 pikselden) daha büyük resimlere ihtiyacınız varsa lütfen destek ekibiyle iletişime geçin ve aşağıdaki bilgileri sağlayın:

1. Kullanım alanınız ve büyük resimlere neden ihtiyacınız olduğu.
2. Diğer Google Haritalar Platformu API'lerini (Haritalar JavaScript API, Maps Embed API, Android için Haritalar SDK'sı veya iOS için Haritalar SDK'sı) kullanmayı düşündünüz mü ve ihtiyaçlarınızı neden karşılamıyorlar?
3. Büyük boyutlu resimleri nasıl kullanacağınıza dair ekran görüntüleri, taslaklar veya örnekler.
4. Büyük boyutlu resimler için tahmini aylık kullanımınız.

İsteğinizi sağladığınız bilgiler doğrultusunda inceleyip kullanım alanınızın Google Haritalar Platformu Hizmet Şartları'na uygun olup olmadığını belirleriz.

Sağlayabileceğimiz maksimum boyut 2048 x 2048 pikseldir.

Sorun giderme ve destek

Maps Static API'yi kullanma hakkında daha fazla bilgi için destek sayfasına göz atın.

Maps Static API, bir sorun oluştuğunda hata veya uyarı yayınlayabilir. Haritadan bir şeyin eksik olduğunu fark ederseniz özellikle uyarıları kontrol etmeniz gerekir. Yeni bir uygulamayı kullanıma sunmadan önce uyarıları kontrol etmek de iyi bir fikirdir. HTTP başlığında göründüklerinden uyarıların hemen fark edilmeyebileceğini unutmayın. Daha fazla bilgi için hatalar ve uyarılar kılavuzunu inceleyin.