Başlayın

Giriş

Maps Static API, bir URL üzerinden HTTP isteğine yanıt olarak 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 isteğe bağlı işaretçilerin haritadaki konumlara yerleşimini belirtebilirsiniz. Ayrıca, işaretçilerinizi alfanümerik karakterler kullanarak etiketleyebilirsiniz.

Haritalar Statik API'si resmi, <img> etiketinin src özelliğine veya diğer programlama dillerindeki eşdeğerine yerleştirilir.

Bu dokümanda, Maps Static API URL'lerinin gerekli biçimi ve kullanılabilen parametreler açıklanmaktadır. Ayrıca, URL'lerinizi belirtmeyle ilgili bazı ipuçlarına ve püf noktalarına işaret eder.

Başlamadan önce

Bu doküman, Haritalar Statik API resimlerini bir web sayfasına veya mobil uygulamaya eklemek isteyen web sitesi ve mobil uygulama geliştiricileri için hazırlanmıştır. Burada, API'nin kullanımına dair temel bilgiler ve mevcut parametrelerle ilgili referans materyaller sağlanmaktadır.

Maps Static API ile geliştirmeye başlamadan önce kimlik doğrulama gereksinimlerini (bir 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

Haritalar Statik 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 Maps Static API görüntülerini de HTTPS üzerinden yüklemeniz gerekir. HTTPS, istekleriniz kullanıcının konumu gibi hassas kullanıcı bilgileri içeriyorsa da önerilir:

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

İster HTTP ister HTTPS kullanılsın, belirli URL parametreleri gereklidir, 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.

Önemli: URL parametreleri ele alındığında, örneklere netlik sağlamak amacıyla çıkış öncesi biçimlerinde verilen örnekler kullanılır. API'ye herhangi bir istek göndermeden önce parametrelerin doğru şekilde URL olarak kodlanmış olması gerekir. Örneğin, birçok parametre ayırıcı olarak dikey çizgi (|) kullanır. Bu karakterin, bu belgenin üst kısmındaki kısa örnekte olduğu gibi nihai URL'de %7C olarak kodlanması gerekir. Daha fazla bilgi için Geçerli Bir URL Oluşturma bölümüne bakın.

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

Konum parametreleri

• center (işaretçiler mevcut değilse zorunludur) haritanın merkezini tanımlar, haritanın tüm kenarlarına eşit uzaklıktadır. Bu parametre, dünya üzerinde benzersiz bir konumu tanımlayan, konumu virgülle ayrılmış bir {latitude,longitude} çifti (ör. "40.714728,-73.998672") veya bir dize adresi (ör. "belediye binası, istanbul, ny") olarak alır. Daha fazla bilgi için Konumlar'a bakın.
• zoom (işaretçiler mevcut değilse zorunludur), haritanın yakınlaştırma düzeyini tanımlar. Bu düzey, haritanın büyütme seviyesini belirler. Bu parametre, istenen bölgenin yakınlaştırma seviyesine karşılık gelen sayısal bir değer alır. Daha fazla bilgi için Yakınlaştırma seviyeleri başlıklı makaleyi inceleyin.

Eşleme 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, daha küçük boyutlu bir Google logosu gösterilir. Bu parametre scale parametresinden etkilenir. Nihai çıktı 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 (yani, harita içeriği değişmeden) scale=1 pikselin iki katı piksel döndürür. Bu, yüksek çözünürlüklü ekranlar için geliştirme yaparken faydalıdır. Varsayılan değer 1 olarak ayarlanmıştır. 1 ve 2 değerleri kabul edilir. 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 birkaç olası biçim vardır. 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ğlar, GIF ve PNG ise 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 haritanın türünü tanımlar. roadmap, satellite, hybrid ve terrain gibi çeşitli eşleme türü değerleri kullanılabilir. Daha fazla bilgi için Haritalar Statik API'si Harita Türleri başlıklı makaleye bakın.
• 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 parçaları için desteklendiğini unutmayın; istenen belirli dil parça grubu için desteklenmiyorsa bu parça grubunun varsayılan dili kullanılır.
• region (isteğe bağlı), jeo-politik hassasiyetlere göre görüntülenecek uygun sınırları tanımlar. İki karakterli 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 stille veya özellikle ilişkilendirir ve haritayı başlatmak için kullanılan API anahtarıyla aynı projeye ait olmalıdır. Daha fazla bilgi edinmek 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, dikey çizgi karakteri (|) ile ayrılmış parametrelere sahip tek bir işaretçi tanımı alır. Aynı stili gösterdikleri sürece aynı markers parametresi içine birden fazla işaretçi yerleştirilebilir. Ek markers parametresi ekleyerek farklı stillerde ilave işaretçiler ekleyebilirsiniz. Bir harita için işaretçiler sağlarsanız center ve zoom parametrelerini (normalde gereklidir) belirtmeniz gerekmediğini unutmayın. Daha fazla bilgi için Haritalar Statik API İşaretçileri başlıklı makaleye bakın.
• path (isteğe bağlı), belirtilen konumlarda resmin üzerine yerleştirilecek iki veya daha fazla bağlantılı noktanın tek bir yolunu tanımlar. Bu parametre, dikey çizgi karakteri (|) ile ayrılmış nokta tanımlarından oluşan bir dize veya yolun konum bildirimindeki enc: ön ekini kullanan kodlanmış çoklu çizgi alır. İlave path parametreleri ekleyerek ek yollar sağlayabilirsiniz. Bir harita için yol sağlarsanız (normalde gereklidir) center ve zoom parametrelerini belirtmenizin 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 konumu belirtir, ancak hiçbir işaretçi ya da başka gösterge görüntülenmez. Maps Static API'de belirli özelliklerin veya harita konumlarının gösterildiğinden emin olmak 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, biçimlendirilecek özellikleri tanımlayan feature ve element bağımsız değişkenleri ile seçilen özelliklere uygulanacak bir dizi stil işlemi alır. İlave style parametreleri ekleyerek birden fazla stil sağlayabilirsiniz. Daha fazla bilgi için styled haritalar rehberine bakın.

Anahtar ve imza parametreleri

• key (zorunlu), Google Cloud Console içinde uygulamanızın API kullanımını izlemenize olanak tanır ve Google'ın gerekirse uygulamanız hakkında sizinle iletişime geçebilmesini sağlar. Daha fazla bilgi için API Anahtarlarını Maps Static API ile kullanma konusuna bakın.
• signature (önerilir), API anahtarınızı kullanarak istek oluşturan tüm sitelerin bunu yapma yetkisine sahip olduğunu doğrulamak için kullanılan dijital bir imzadır. Dijital imza olmayan 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'lerinin boyutu 16384 karakterle sınırlandırılmıştır. Çok sayıda işaretçi ve yola sahip karmaşık haritalar oluşturmadığınız sürece, pratikte muhtemelen bundan daha uzun URL'lere ihtiyacınız olmayacaktır.

Parametre Kullanımı

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

Konumları Belirtme

Maps Static API, hem haritayı doğru konuma odaklayabilmek (center parametresini kullanarak) hem de (markers parametresini kullanarak) harita üzerindeki konumlara isteğe bağlı yer işaretleri yerleştirebilmek için harita üzerindeki 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 bir konumu tanımlar.

Çeşitli parametreler (markers ve path parametreleri gibi) birden fazla konumda yer alır. Böyle durumlarda konumlar dikey çizgi (|) karakteriyle ayrılır.

Enlemler ve boylamlar

Enlemler ve boylamlar, virgülle ayrılmış bir metin dizesinde 6 ondalık basamağa kadar hassasiyete sahip sayılar kullanılarak tanımlanır. Örneğin, "40.714728,-73.998672" geçerli bir coğrafi kod değeridir. 6 ondalık basamaktan sonraki hassasiyet göz ardı edilir.

Boylam değerleri, başlangıç meridyenin bulunduğu İngiltere, Greenwich'e olan mesafelerine dayanır. Greenwich, enlem 51.477222'de bulunduğu için Greenwich'te haritanın merkezine center olarak 51.477222,0 girebilirsiniz:

Örnekler, bölgenizde kullanılamıyor olabilir.

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

Adresler

Çoğu kişi enlem ve boylam söylemez. Bu kelimeler, konumları adres kullanarak belirtir. Bir adresi coğrafi noktaya dönüştürme işlemi coğrafi kodlama olarak bilinir ve geçerli adresler sağlarsanız Maps Static API hizmeti sizin için coğrafi kodlama yapabilir.

Enlem/boylam belirtebileceğiniz tüm parametrelerde, adresi belirten bir dize de belirtebilirsiniz. Google, adresin coğrafi kodlamasını yapar ve işaretçilerin yerleştirilmesinde ya da yerlerin belirtilmesinde kullanılması için Haritalar Static API hizmetine bir enlem/boylam değeri sağlar. Dizenin URL kodlamalı olması gerekir. Bu nedenle, örneğin "Belediye Binası, New York, NY" gibi adresler "Şehir+Salon,New+York,NY" gibi dönüştürülmelidir.

Adreslerin açık adres gibi kesin konumları, adlandırılmış rota gibi çoklu çizgileri veya şehir, ülke veya milli park gibi poligon alanları yansıtabileceğini unutmayın. Poli doğrusal ve poligon sonuçlar için Haritalar Statik API sunucusu, adres merkezi olarak çizginin/alanın merkez noktasını kullanır. Bir adresin coğrafi kodlaması hakkında şüpheniz varsa bu Coğrafi Kodlama Yardımcı Programı'nı kullanarak adresi test edebilirsiniz.

Not: İnsanlar tarafından okunabilir adres dizeleri veya çoklu çizgiler gibi coğrafi kodlama gerektiren bir yöntem kullanarak konum belirtmeyi seçerseniz istek en fazla 15 konumla sınırlandırılır. Bu sınır yalnızca coğrafi kodlama gerektiren konumlar için geçerlidir. Enlem/boylam koordinatlarıyla belirtilen konumlar için geçerli değildir.

Aşağıdaki örnekte Berkeley, CA için statik bir harita görüntüsü oluşturulmuştur:

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

Örnekler, bölgenizde kullanılamıyor olabilir.

Yakınlaştırma seviyeleri

Google Haritalar'daki haritalarda, geçerli görünümün çözünürlüğünü tanımlayan bir tam sayı "yakınlaştırma düzeyi" bulunur. Varsayılan roadmap görünümünde, 0 (tüm dünyanın bir haritada görülebildiği en düşük yakınlaştırma düzeyi) ile 21+ (sokaklara ve tek tek binalara) arasındaki yakınlaştırma seviyeleri kullanılabilir. Mevcut olduğu durumlarda yapı ana hatları, haritada 17 yakınlaştırma düzeyinin etrafında gösterilir. Bu değer alandan bölgeye değişir ve veriler geliştikçe zaman içinde değişebilir.

Google Haritalar, tüm dünyayı kapsayacak şekilde yakınlaştırma düzeyini (0) ayarlıyor. Başarılı olan her yakınlaştırma düzeyi, hem yatay hem de dikey boyutlardaki hassasiyeti iki katına çıkarır. Bunun nasıl yapıldığı konusunda daha fazla bilgiyi Google Maps JavaScript API dokümanlarında bulabilirsiniz.

Not: Tüm yakınlaştırma düzeyleri dünyadaki tüm konumlarda görünmez. Yerkürenin bazı bölgelerindeki veriler diğerlerine göre daha ayrıntılı olduğundan, yakınlaştırma seviyeleri konuma bağlı olarak değişir.

Hiç harita karosunun bulunmadığı bir yakınlaştırma düzeyi için istek gönderirseniz, Haritalar Statik API'si 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ğerine sahip ancak sırasıyla 12 ve 14 yakınlaştırma seviyelerinde iki Manhattan haritası talep edilmektedir:

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

  

Örnekler, bölgenizde kullanılamıyor olabilir.

Resim boyutları:

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

Bu tabloda, her bir scale değeri için size parametresi için izin verilen maksimum değerler gösterilmektedir.

scale=1	scale=2
640x640	640x640 (1280x1280 piksel döndürür)

Bu örnekte, ekvatordan 1. yakınlaştırma seviyesindeki dünya "dilimi" istenmiştir:

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ölgede ortalanmış, 100 x 100 piksel boyutunda küçük bir harita istenmiştir. Daha küçük olan 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

Örnekler, bölgenizde kullanılamıyor olabilir.

Değerleri ölçeklendirin

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

Ancak mobil cihazlar giderek artan bir şekilde, 300 ppi'nin üzerinde piksel yoğunluğuna sahip yüksek çözünürlüklü ekranlar içerir. Bu ekranlar şunlardır:

• 200x200 piksellik bir resmin boyutunu 0,7 inçin yalnızca 0,7'sine düşürerek etiketleri ve simgeleri okunamayacak kadar küçük hale getirme veya
• Daha kolay okunabilmesi için resmi ölçeklendirerek (yakınlaştırarak bulanık veya pikselleştirilmiş resim) elde edin.

Çok küçük	Çok bulanık

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

Örneğin, 2 ölçek değeri, ölçek belirtilmemiş bir istekle aynı harita kapsam alanını döndürür, ancak her bir boyutta iki kat daha fazla piksel bulunur. Yollar ve etiketler, hem yüksek çözünürlüklü, küçük boyutlu ekranlarda hem de tarayıcı tarafından ölçeklendiğinde okunabilir olmasını sağlayan yollar ve etiketler de buna dahildir.

150x150	150x150&ölçek=2

Böyle bir resim, yüksekliği ve genişliği CSS kullanılarak ayarlanmış bir img veya div etiketine eklendiğinde masaüstü tarayıcılarda da iyi performans gösterir. Tarayıcı, kaliteden ödün vermeden resmi doğru boyuta küçültür.

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

• İlki, ölçek değeri belirtilmemiş 100x100 boyutunda bir resimdir. Masaüstünde düzgün bir şekilde görüntülenir ancak mobil cihazda okunamayacak kadar küçüktür.
• İkincisi, harita boyutunu ikiye katlar. CSS, masaüstünde bunu belirtilen 100x100 img öğesine sığdırır ancak resmin boyutu küçültüldüğünde yollar ve etiketler çok küçük hale gelir. Mobil cihazda, resmin doğru boyutta olduğu halde yollar ve etiketler okunaksız.
• Üçüncü istek, scale=2 içeren 100x100 boyutunda bir harita içindir. Resim, 200 piksellik ayrıntıyla döndürülür. Masaüstü bilgisayar, resmi orijinal 100x100 isteğinden ayırt edilemeyecek şekilde mükemmel şekilde küçültürken mobil tarayıcı, API'nin döndürdüğü ek çözünürlükten 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üle edilmiş)

İpucu: Android ve iOS gibi mobil platformlar, her çözünürlük için ayrı resimler belirterek uygulamaların yüksek çözünürlüklü ekranları desteklemesini sağlar. Ölçek parametresi, standart çözünürlüklü ekran için harita resmi, yüksek çözünürlüklü ekran için eşleşen harita istemeyi kolaylaştırır. Bunun için sırasıyla scale=1 ve scale=2 değerlerini ayarlamanız yeterlidir.

Mobil ve yüksek çözünürlüklü ekranlar için geliştirme hakkında daha fazla bilgi edinmek istiyorsanız aşağıdaki kaynakları okumanız önerilir:

• Android geliştirici belgelerinden Supporting Multiple Screens (Birden Fazla Ekranı Destekleme) başlıklı makaleyi inceleyin.
• Webkit.org'un Yüksek DPI Web Siteleri geliştirme önerileri.
• iOS Geliştirici Kitaplığı'nda Yüksek Çözünürlüklü Ekranları Destekleme.

Resim biçimleri

Resimler, yaygın kullanılan birkaç web grafiği biçimlerinde 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, progresif olmayan bir JPEG sıkıştırma biçimi belirtir.

Aşağıdaki örneklerde, gif ve png biçimlerindeki harita isteği verilebilir:

  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 bu işlemi, resmin bozulmasına neden olabilecek "kayıplı" sıkıştırma yoluyla yaparlar. gif, png8 ve png32 kayıpsız sıkıştırma sağlar.

Çoğu JPEG resmi progresiftir. Yani daha kaba bir resim daha erken yüklenir ve daha fazla veri geldikçe resim çözünürlüğünü hassaslaştırır. Bu, resimlerin web sayfalarında hızlı bir şekilde yüklenmesine olanak tanır ve şu anda JPEG'in en yaygın kullanımıdır. Bununla birlikte, bazı JPEG kullanımları progresif olmayan (temel) resimler gerektirir. 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ü belirtiyor.
• terrain, arazi ve bitki örtüsünü gösteren fiziksel bir kabartma harita resmini belirtir.
• hybrid, uydu görüntüsünde önemli caddeler ve yer adlarının şeffaf bir katmanını gösteren uydu ve yol haritası görüntüsünün karmasını belirtir.

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

  

Örnekler, bölgenizde kullanılamıyor olabilir.

Karma haritalar, uydu görüntülerini ve önemli yol haritası özelliklerini kullanarak karma harita oluşturur. 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

  

Örnekler, bölgenizde kullanılamıyor olabilir.

Stilli haritalar

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

İşaretçiler

markers parametresi, belirli bir konum grubundaki bir veya daha fazla işaretçiyi (harita raptiyeleri) tanımlar. Tek bir markers bildiriminde tanımlanan her işaretçi aynı görsel stili sergilemelidir. İşaretçileri farklı stillerde görüntülemek isterseniz ayrı stil bilgileriyle birden fazla markers parametresi sağlamanız gerekir.

markers parametresi, aşağıdaki biçimdeki değer atamalarını (işaretçi tanımlayıcıları) alır:

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

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

Hem stil bilgileri hem de konum bilgileri dikey çizgi karakteriyle sınırlandırı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 açıklayı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 açıklayıcıları grubu, dikey çizgi (|) karakteriyle ayrılmış bir değer ataması dizisidir. Bu stil açıklayıcı, bu işaretçi açıklayıcı içinde işaretçiler görüntülenirken 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} kümesinden işaretçinin boyutunu belirtir. Hiçbir size parametresi ayarlanmazsa işaretçi varsayılan (normal) boyutunda görünür.

• color: (isteğe bağlı), 24 bit bir renk (örnek: color=0xFFFFCC) veya {black, brown, green, purple, yellow, blue, gray, orange, red, white} kümesinden önceden tanımlanmış bir renk belirtir.

  Saydamların (32 bit onaltılık renk değerleri kullanılarak belirtilir), yollar için desteklense de işaretçilerde desteklenmediğini unutmayın.

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

Not: Bu işaretçileri kullanmak yerine kendi özel simgenizi kullanabilirsiniz. (Daha fazla bilgi için Özel simgeler bölümüne bakın.)

İşaretçi ölçeklendirme

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

Resimlere ilişkin piksel boyutu sınırı, ölçeklendirme uygulandıktan sonra geçerli olur. Örneğin, işaretçi scale:2 olarak ayarlanırsa işaretçi, ölçeklendirmeden sonra 4.096 pikselin altına indiği sürece maksimum 4.096 piksel boyutundan daha büyük olabilir. Daha yüksek çözünürlüklü haritaları görüntülerken harita ölçeklendirme ile birlikte işaretçi ölçeklendirmeyi kullanın.

İşaretçi konumları

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

Not: İşaretçi konumlarını, coğrafi kodlama gerektiren bir yöntem (ör. insan tarafından okunabilir adres dizeleri veya çoklu çizgiler) kullanarak belirtmeyi seçerseniz istek en fazla 15 işaretçiyle sınırlandırılı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 harita dışındaysa center ve zoom parametrelerinin sağlanması koşuluyla bu işaretçi oluşturulan resimde görünmez. Ancak bu parametreler sağlanmazsa Maps Static API sunucusu otomatik olarak, sağlanan işaretçileri içeren bir resim oluşturur. (Örtülü konumlandırma konusuna bakın.)

Örnek bir işaretçi beyanı burada gösterilmiştir. Bir stil grubu ve üç yer 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

Örnekler, bölgenizde kullanılamıyor olabilir.

Farklı stillere sahip işaretçiler tanımlamak için birden fazla markers parametresi sağlamamız gerekir. Bu markers parametresi grubu üç işaretçiyi tanımlar: 62.107733, -145.5419 olarak "S" etiketli bir mavi işaretçi, "Delta Junction, AK"de küçük bir yeşil işaretçi ve "Tok, AK"de "C" etiketli orta boyutlu bir sarı işaretçi. Bu işaretçiler bu örnekte gösterilmektedir:

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

Örnekler, bölgenizde kullanılamıyor olabilir.

Özel simgeler

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

markers=icon:URLofIcon|markerLocation

icon öğesini bir URL kullanarak belirtin (bu, URL olarak kodlanmış olmalıdır). https://goo.gl gibi URL kısaltma hizmetleri tarafından oluşturulan URL'leri kullanabilirsiniz. Çoğu URL kısaltma hizmeti, 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 simgenin sabitleme noktası simge resminin alt orta noktasıdır. icon ile birlikte anchor açıklayıcıyı kullanarak farklı bir sabitleme noktası belirtebilirsiniz. anchor öğesini, simgenin x,y noktası (10,5 gibi) veya aşağıdaki 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

İstek başına en fazla beş benzersiz özel simge kullanabilirsiniz. Bu sınırlama, haritanızda yalnızca 5 işaretlenmiş 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çimlerinde olabilir ancak PNG önerilir.
• Simgelerin boyutu en fazla 4096 piksel olabilir (kare resimler için 64x64).

Özel simge örnekleri

1. Örnek, özel simgeler oluşturur ve bağlantıları kullanarak simgeleri konumlandırı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=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

Örnekler, bölgenizde kullanılamıyor olabilir.

2. Örnek, 1. örnekle aynı özel simgeleri oluşturur, ancak alt ortadaki varsayılan sabitleyiciyi kullanarak simge konumlarını ayarlamaz.

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

Örnekler, bölgenizde kullanılamıyor olabilir.

Haritalar Statik API yolları

path parametresi, harita resmi üzerinde yer paylaşımı yapacak şekilde bir yolla bağlanan bir veya daha fazla konum grubunu tanımlar. path parametresi, aşağıdaki biçimdeki değer atamalarını (yol tanımlayıcıları) alır:

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

Her iki yol noktasının da dikey çizgi karakteri (|) kullanılarak ayrıldığını unutmayın. Hem stil bilgileri hem de nokta bilgileri dikey çizgi karakteriyle sınırlandırıldığından, stil bilgileri ilk olarak herhangi bir yol açıklayıcıda görünmelidir. Maps Static API sunucusu yol açıklayı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ıları grubu, dikey çizgi (|) karakteriyle ayrılmış bir değer ataması dizisidir. Bu stil açıklayıcı, yolu gösterirken 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. Hiçbir weight parametresi ayarlanmazsa yol, varsayılan kalınlığında (5 piksel) görünür.

• color: (isteğe bağlı), 24 bit (örnek: color=0xFFFFCC) veya 32 bit onaltılık değer (örnek: color=0xFFFFCCFF) ya da {black, brown, green, purple, yellow, blue, gray, orange, red, white} kümesinden bir renk belirtir.

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

• fillcolor: (isteğe bağlı), hem yolun poligonal bir alanı işaretlediğini hem de bu alan içinde yer paylaşımı olarak kullanılacak dolgu rengini belirtir. Sonraki konum kümesinin "kapalı" döngü olması gerekmez. Haritalar Statik API sunucusu, ilk ve son noktalara otomatik olarak katılır. Ancak özellikle aynı başlangıç ve bitiş konumunu belirtmediğiniz sürece, doldurulmuş alanın dış kısmındaki herhangi bir çizginin kapatılmayacağını unutmayın.
• geodesic: (isteğe bağlı), istenen yolun, dünyanın eğriliğini izleyen jeodezik bir çizgi olarak yorumlanması gerektiğini belirtir. Yanlış olduğunda yol, ekran alanında düz bir çizgi olarak oluşturulur. Varsayılan olarak false (yanlış) değerine ayarlanır.

Bazı örnek yol tanımları:

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

Bu yol stilleri isteğe bağlıdır. Varsayılan özellikler istenirse yol özelliklerini tanımlamayı atlayabilirsiniz. Bu durumda, bildirilen ilk nokta (konum) yerine yol tanımlayıcının ilk "bağımsız değişkeni" oluşturulur.

Yol noktaları

Bir yol çizebilmek için path parametresi de iki veya daha fazla nokta iletilmelidir. Daha sonra Maps Static API, yolu bu noktalarda belirtilen sırada bağlar. Her pathPoint, pathDescriptor'da | (dikey çizgi) karakteriyle ayrılmış şekilde gösterilir.

Aşağıdaki örnekte, Union Square NY ile Times Meydanı, NY arasında varsayılan% 50 opaklığa sahip mavi bir yol tanımlanmaktadır.

Örnekler, bölgenizde kullanılamıyor olabilir.

path parametresinin özellikleri:

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 düz kırmızı bir çizgi tanımlamak yerine aynı yol tanımlanmaktadır:

Örnekler, bölgenizde kullanılamıyor olabilir.

Bu path parametresinin özellikleri:

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

Sonraki örnekte Manhattan'daki bir poligonal alan tanımlanarak bir dizi kesişim konum olarak geçmiştir:

Örnekler, bölgenizde kullanılamıyor olabilir.

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

Unutmayın, yolun kendisini görünmez, çokgen alanı ise% 15 opaklığa sahip olur.

Kodlanmış çoklu çizgiler

Konum serisi yerine yolu, path ile ilgili konum beyanında enc: önekini kullanarak kodlanmış çoklu çizgi olarak belirtebilirsiniz.

Aşağıdaki örnekte, Alaska Otoyolu'nun Dawson Deresi, BC'den Delta Junction, AK'ye kadar kodlanmış bir çoklu çizgiyle rotası gösterilmiştir:

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}%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA}f[roaAynd@%7CvXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o%7CF}vXaj\h`]ovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh`]v%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k%7CDh_z@nwB%7Ckb@a{R%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY}t]huf@e%7CFria@o}GfezAkdW%7C}[ocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C`l@uoJrvdAgq@fppAsjGhg`@%7ChQpg{Ai_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C}[mv`@t_NitSfjp@c}Mhg`@sbChyYq}e@rwg@atFff}@ghN~zKybk@fl}A}cPftcAite@tmT__Lha@u~DrfQi}MhkSqyWivIumCria@ciO_tHifm@fl}A{rc@fbjAqvg@rrqAcjCf%7Ci@mqJtb^s%7C@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Örnekler, bölgenizde kullanılamıyor olabilir.

Standart yollarda olduğu gibi, path parametresine bir fillcolor bağımsız değişkeni aktarılırsa kodlanmış çoklu çizgi yolları da poligon alanları sınırlandırabilir.

Aşağıdaki örnekte Brooklyn, NY için bir poligon alan gösterilmiştir:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:}zswFtikbMjJzZ%7CRdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A%7CPfYlvApz@bl@tcAdTpGpVwQtX}i@%7CGen@lCeAda@bjA%60q@v}@rfAbjA%7CEwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ%7C[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB }}Ay%60@%7CEKv_@?%7C[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm%7CB~j@zC~hAyUyJ_U{Z??cPvg@}s@sHsc@_z@cj@kp@YePoNyYyb@_iAyb@gBw^bOokArcA}GwJuzBre@i\tf@sZnd@oElb@hStW{]vv@??kz@~vAcj@zKa%60Atf@uQj_Aee@pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Örnekler, bölgenizde kullanılamıyor olabilir.

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 durumda kalması için bir harita oluşturması talimatını verir. (Bu parametre, görünür bir bölgeyi de tanımlamak için mevcut işaretçiler veya yollarla birleştirilebilir.) Bir görüntü alanının bu şekilde tanımlanması, kesin bir yakınlaştırma düzeyi belirtme ihtiyacını ortadan kaldırır.

Bir sonraki örnekte, Boston, MA'yı merkeze alan ve hem MIT hem de Cambridge, MA'daki Harvard Meydanı'nı içeren bir harita istenmiştir:

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

Örnekler, bölgenizde kullanılamıyor olabilir.

Haritanın dolaylı konumlandırması

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. Bununla birlikte, markers, path veya visible parametreleri sağlarsanız, bu öğelerin konumlarının değerlendirilmesi temelinde Maps Static API'nin doğru merkez ve yakınlaştırma düzeyini örtülü olarak belirlemesine izin verebilirsiniz.

İki veya daha fazla öğe sağlanıyorsa Maps Static API uygun bir merkez ve yakınlaştırma düzeyi belirler. Bu sayede, içerdiği öğeler için cömert kenar boşlukları sağlanır. 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

Örnekler, bölgenizde kullanılamıyor olabilir.

Daha büyük resim boyutları

Boyutları 640 x 640 pikselden (veya ölçek değeri 2 olan 1280 x 1280 piksel) 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 neden büyük boyutlu resimlere ihtiyaç duyduğunuz
2. Diğer Google Haritalar Platformu API'lerini (Haritalar JavaScript API'si, Maps Embed API, Android için Haritalar SDK'sı veya iOS için Haritalar SDK'sı) kullanmayı düşünüp düşünmediğinize ve ihtiyaçlarınızı karşılamamanın nedeni
3. Büyük boyutlu resimleri nasıl kullanacağınızla ilgili ekran görüntüleri, örnekler veya örnekler.
4. Büyük boyutlu resimler için tahmini aylık kullanımınız.

İsteğinizi sağladığınız bilgilere göre 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 edinmek için destek sayfasına göz atın.

Maps Static API bir şeyler ters gittiğinde hata veya uyarı yayınlayabilir. Haritada bir şeyin eksik olduğunu fark ederseniz uyarıları özellikle kontrol etmelisiniz. Yeni bir uygulamayı kullanıma sunmadan önce de uyarıları kontrol etmek iyi bir fikirdir. Uyarıların HTTP üst bilgisinde göründüğü için hemen görünmeyebileceğini unutmayın. Daha fazla bilgi için hatalar ve uyarılar kılavuzuna bakın.