Başlarken

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Fatura adresiniz Avrupa Ekonomik Alanı'ndaysa 8 Temmuz 2025'ten itibaren Hizmetler'i kullanımınız Google Haritalar Platformu AEA Hizmet Şartları'na tabi olacaktır. Daha fazla bilgi edinin. Ayrıca, Maps Static API'deki belirli içerikler artık döndürülmeyecek. Daha fazla bilgi edinin.

Giriş

Maps Static API, bir URL aracılığıyla gönderilen 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 seviyesini, haritanın türünü ve haritadaki konumlara isteğe bağlı işaretçilerin yerleşimini 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 gerekli biçimi ve kullanılabilir parametreler açıklanmaktadır. Ayrıca, URL'lerinizi belirtmeyle ilgili bazı ipuçları ve püf noktaları da sunar.

Başlamadan önce

Bu doküman, bir web sayfasına veya mobil uygulamaya Maps Static API resimleri eklemek isteyen web sitesi ve mobil uygulama geliştiricileri için hazırlanmıştır. Bu kılavuzda, API'nin kullanımına giriş bilgileri ve mevcut parametrelerle ilgili referans materyalleri yer alır.

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ından kaçınmak için Maps Static API resimlerini de HTTPS üzerinden yüklemeniz gerekir. İstekleriniz kullanıcının konumu gibi hassas kullanıcı bilgileri içeriyorsa HTTPS kullanmanız önerilir:

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

HTTP veya HTTPS kullanırken belirli URL parametreleri zorunlu, bazıları ise isteğe bağlıdır. URL'lerde standart olduğu gibi, tüm parametreler ve işareti (&) karakteri kullanılarak ayrılır. Parametrelerin listesi ve olası değerleri bu dokümanda sıralanmıştır.

Önemli: URL parametreleriyle ilgili açıklamada, anlaşılır olması için kaçış karakteri eklenmemiş örnekler kullanılmıştır. API'ye istek göndermeden önce parametreleri doğru şekilde URL kodlamalı olmalıdır. Örneğin, birçok parametre ayırıcı olarak dikey çizgi karakteri (|) kullanır. Bu karakter, bu dokümanın üst kısmındaki kısa örnekte olduğu gibi nihai URL'de %7C olarak kodlanmalıdır. Daha fazla bilgi için Geçerli bir URL oluşturma başlıklı makaleyi inceleyin.

Maps Static API, harita resimlerini aşağıdaki URL parametrelerini kullanarak tanımlar:

Konum parametreleri

• center (işaretçiler yoksa gerekli), haritanın tüm kenarlarına eşit uzaklıkta olan harita merkezini tanımlar. Bu parametre, konumu virgülle ayrılmış {enlem,boylam} çifti (ör. "40.714728,-73.998672") veya dünya üzerinde benzersiz bir konumu tanımlayan dize adresi (ör. "city hall, new york, ny") olarak alır. Daha fazla bilgi için Konumlar bölümüne bakın.
• zoom (işaretçiler yoksa gerekli), haritanın büyütme seviyesini belirleyen yakınlaştırma seviyesini tanımlar. 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 bölümüne bakın.

Harita parametreleri

• size (zorunlu), harita resminin 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 Google logosu daha küçük boyutta 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 (yani haritanın içeriği değişmez) scale=1 kadar pikselin iki katını döndürür. Bu, yüksek çözünürlüklü ekranlar için geliştirme yaparken 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ı), sonuç resminin biçimini tanımlar. Maps Static API, varsayılan olarak PNG resimleri oluşturur. GIF, JPEG ve PNG türleri dahil olmak üzere birkaç olası biçim vardır. Kullanacağınız biçim, 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 haritanın türünü tanımlar. roadmap, satellite, hybrid ve terrain gibi birkaç olası maptype değeri vardır. Daha fazla bilgi için Maps Static API harita türleri başlıklı makaleyi inceleyin.
• colorscheme (isteğe bağlı), haritanın renk şemasını tanımlar. Kabul edilen değerler light (varsayılan) ve dark değerleridir. Koyu renk şeması, roadmap ve terrain harita türleri için geçerlidir. Daha fazla bilgi için Modlar ve harita türleri hakkında bilgi başlıklı makaleyi inceleyin.
• language (isteğe bağlı), harita parçalarındaki etiketlerin gösterileceği dili tanımlar. Bu parametrenin yalnızca bazı ülke karoları için desteklendiğini unutmayın. İstenen dil, karo grubu için desteklenmiyorsa ilgili karo grubunun varsayılan dili kullanılır.
• region (isteğe bağlı), jeopolitik 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ı ilk kullanıma hazırlamak 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, parametreleri dikey çizgi karakteriyle (|) ayrılmış tek bir işaretçi tanımı alır. Aynı stilde oldukları sürece aynı markers parametresine birden fazla işaretçi yerleştirilebilir. Farklı stillerdeki ek işaretçileri, ek markers parametreleri ekleyerek ekleyebilirsiniz. Bir harita için işaretçiler sağlarsanız (normalde gerekli olan) center ve zoom parametrelerini belirtmeniz gerekmez. Daha fazla bilgi için Maps Static API İşaretçileri başlıklı makaleyi inceleyin.
• path (isteğe bağlı), belirtilen konumlarda resmin üzerine yerleştirilecek iki veya daha fazla bağlı noktadan oluşan tek bir yol tanımlar. Bu parametre, dikey çizgi karakteriyle (|) ayrılmış bir nokta tanımları dizesi veya yolun konum bildiriminde enc: ön ekini kullanan kodlanmış bir çoklu çizgi alır. Ek path parametreleri ekleyerek başka yollar da sağlayabilirsiniz. Bir harita için yol sağlarsanız (normalde gerekli olan) center ve zoom parametrelerini belirtmeniz gerekmez. Daha fazla bilgi için Maps Static 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 işaretçi veya başka göstergeler gösterilmez. 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çilen özelliklere uygulanacak bir dizi stil işlemini alır. Ek style parametreleri ekleyerek birden fazla stil sağlayabilirsiniz. Daha fazla bilgi için stil özellikli haritalar kılavuzuna bakın.

Anahtar ve imza parametreleri

• key (gerekli), uygulamanızın API kullanımını Google Cloud Console'da izlemenize olanak tanır ve Google'ın gerektiğinde uygulamanızla ilgili olarak sizinle iletişime geçebilmesini sağlar. Daha fazla bilgi için Maps Static API ile API anahtarlarını kullanma başlıklı makaleyi inceleyin.
• signature (önerilir), API anahtarınızı kullanarak istek oluşturan sitelerin 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 imza kullanma başlıklı makaleyi inceleyin.

URL boyutu kısıtlaması

Maps Static API URL'leri 16.384 karakterle sınırlıdır. Uygulamada, ç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 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, URL'lerinizi oluşturmak için bu parametreleri nasıl kullanacağınız açıklanmaktadır.

Konumları belirleme

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

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

Enlem ve boylamlar

Enlem ve boylamlar, virgülle ayrılmış bir metin dizesinde 6 ondalık basamak hassasiyetine 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 yoksayılır.

Boylam değerleri, başlangıç meridyeninin bulunduğu Greenwich, İngiltere'ye olan uzaklığa göre belirlenir. Greenwich 51,477222 enleminde yer aldığından, haritayı Greenwich'te ortalamak 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. Enlem değerleri -90 ile 90 arasında, boylam değerleri 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 boylamlarla konuşmaz, konumları adresleri kullanarak belirtir. Bir adresi coğrafi noktaya dönüştürme işlemi coğrafi kodlama olarak bilinir. Geçerli adresler sağlarsanız Maps Static API hizmeti sizin için coğrafi kodlama yapabilir.

Enlem/boylam sağlayabileceğiniz herhangi bir parametrede, bunun yerine bir adres belirten dize belirtebilirsiniz. Google, adresi coğrafi olarak kodlar ve işaretçi yerleştirmede veya konum belirtmede kullanılacak bir enlem/boylam değeriyle Maps Static API hizmetini sağlar. Dize URL kodlamalı olmalıdır. Bu nedenle, "City Hall, New York, NY" gibi adresler "City+Hall,New+York,NY" biçimine dönüştürülmelidir.

Adreslerin açık adresler gibi tam konumları, adlandırılmış rotalar gibi çoklu çizgileri veya şehirler, ülkeler ya da milli parklar gibi çokgen alanları yansıtabileceğini unutmayın. Çoklu çizgi ve çokgen sonuçlar için Maps Static API sunucusu, çizginin/alanın merkez noktasını adres merkezi olarak kullanır. Bir adresin nasıl coğrafi kodlanacağı konusunda şüpheniz varsa bu Coğrafi Kodlama Yardımcı Programı'nı kullanarak adresi test edebilirsiniz.

Not: Konumları, coğrafi kodlama gerektiren bir yöntem (ör. kullanıcı tarafından okunabilen adres dizeleri veya çoklu çizgiler) kullanarak belirtmeyi seçerseniz istek en fazla 15 konumla sınırlıdı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, Kaliforniya 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 haritalarda, geçerli görünümün çözünürlüğünü tanımlayan bir tam sayı "yakınlaştırma seviyesi" vardır. Varsayılan roadmap görünümünde, 0 (tüm dünyanın tek bir haritada görülebildiği en düşük yakınlaştırma seviyesi) ile 21+ (sokaklara ve tek tek binalara kadar) arasındaki yakınlaştırma seviyeleri kullanılabilir. Mevcut olduğu durumlarda bina ana hatları, haritada yaklaşık 17 yakınlaştırma seviyesinde görünür. Bu değer, bölgeden bölgeye farklılık gösterir ve veriler geliştikçe zaman içinde değişebilir.

Google Haritalar, tüm dünyayı kapsayacak şekilde yakınlaştırma seviyesini 0 olarak ayarlar. Her bir yakınlaştırma seviyesi, hem yatay hem de dikey boyutlarda hassasiyeti iki katına çıkarır. Bunun nasıl yapılacağı hakkında daha fazla bilgi için Google Haritalar JavaScript API belgelerini inceleyin.

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

Harita karolarının bulunmadığı bir yakınlaştırma seviyesi için istek gönderirseniz Maps Static API, bunun yerine boş bir resim döndürür.

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

• 1: Dünya
• 5: Kara parçası/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 seviyelerinde iki Manhattan haritası istenmektedir:

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 kapsama 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 bir scale değeri için size parametresinin izin verilen maksimum değerleri gösterilmektedir.

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

Bu örnekte, ekvatorda 1. yakınlaştırma seviyesinde bir dünya "dilimi" istenmektedir:

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ölgeyi ortalayan 100 x 100 piksel boyutunda küçük bir harita istenmektedir. 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, haritanın piksel cinsinden boyutunu tanımlar. Böylece size=200x200 içeren bir harita 200 piksele 200 piksel olarak 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 boyutundaki bir harita her boyutta yaklaşık 2 inç olacaktır.

Ancak mobil cihazlar, giderek daha fazla oranda 300 ppi'nin üzerinde piksel yoğunluğuna sahip yüksek çözünürlüklü ekranlar içerir. Bu ekranlar:

• 200x200 piksellik bir resmin boyutunu yalnızca 0,7 inç olacak şekilde küçülterek etiketleri ve simgeleri okunmayacak kadar küçük hale getirme veya
• Okunabilirliği artırmak için resmi ölçeklendirme (yakınlaştırma) sonucunda bulanık veya pikselli bir resim elde etme.

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

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

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

150x150	150x150&scale=2

Bu tür bir resim, CSS kullanılarak yükseklik ve genişlik ayarlanmış bir img veya div etiketine eklendiğ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.

• İlkinde, ölçek değeri belirtilmeden 100x100 boyutunda bir resim kullanılmıştır. Masaüstünde düzgün 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 resim küçültüldüğünde yollar ve etiketler çok küçük hale gelir. Mobil cihazda resim doğru boyutta ancak yollar ve etiketler yine okunamıyor.
• Üçüncü istek, scale=2 ile 100x100 boyutunda bir harita içindir. Resim 200 piksel ayrıntıyla döndürülür. Masaüstü, resmi mükemmel bir şekilde küçültür, böylece orijinal 100x100 isteğinden ayırt edilemez. Mobil tarayıcı ise API tarafından döndürülen 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ü bir ekran için harita resmi ve yüksek çözünürlüklü bir ekran için eşleşen haritayı 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 makaleleri okumanızı öneririz:

• Android geliştirici belgelerindeki Birden Fazla Ekranı Destekleme bölümüne bakın.
• Webkit.org'un Yüksek DPI'lı Web Siteleri geliştirme önerileri.
• iOS Geliştirici Kitaplığı'ndaki Supporting High-Resolution Screens (Yüksek Çözünürlüklü Ekranları Destekleme) bölümüne bakın.

Resim biçimleri

Resimler, yaygın olarak kullanılan çeşitli 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, aşamalı olmayan bir JPEG sıkıştırma biçimi belirtir.

Bu örneklerde, gif ve png biçimlerinde haritalar istenmektedir:

  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, resmi bozabilecek "kayıplı" sıkıştırma yoluyla yapar. gif, png8 ve png32, kayıpsız sıkıştırma sağlar.

Çoğu JPEG resmi aşamalıdır. Yani önce daha kaba bir resim yüklenir ve daha fazla veri geldikçe resim çözünürlüğü iyileştirilir. Bu sayede resimler web sayfalarında hızlı bir şekilde yüklenebilir. JPEG'in günümüzdeki en yaygın kullanım alanı budur. Ancak JPEG'in bazı kullanımları, aşamalı 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österilen standart bir yol haritası resmi belirtir. maptype değeri belirtilmezse Maps Static API varsayılan olarak roadmap karoları sunar.
• satellite, bir uydu görüntüsünü belirtir.
• terrain, araziyi ve bitki örtüsünü gösteren fiziksel bir kabartma harita görüntüsü belirtir.
• hybrid, uydu ve yol haritası görüntüsünün bir karışımını belirtir. Uydu görüntüsünde ana caddelerin ve yer adlarının şeffaf bir katmanını gösterir.

Bu kod örneğinde yol haritası ve 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, uydu görüntülerini ve belirgin yol haritası özelliklerini kullanarak birleşik bir harita oluşturur. Aşağıdaki örneklerde uydu ve karma harita türleri gösterilmektedir:

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 özellikli haritalar

Kendi stillerinizi uygulayarak standart Google haritasının sunumunu özelleştirin. Stil özellikli haritalar kılavuzuna bakın.

İşaretçiler

markers parametresi, bir dizi konumda bir veya daha fazla işaretçi (harita raptiyesi) tanımlar. Tek bir markers beyanı içinde tanımlanan her işaretçi aynı görsel stili sergilemelidir. Farklı stillere sahip 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çimde bir değer atamaları kümesi (işaretçi tanımlayıcıları) 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ıdan ve ardından yine dikey çizgi karakteriyle (|) ayrılmış bir veya daha fazla konumdan oluşur.

Hem stil bilgileri hem de konum bilgileri dikey çizgi karakteriyle sınırlandırıldığından, stil bilgileri her işaretçi tanımlayıcısında ilk sırada görünmelidir. Maps Static API sunucusu, işaretçi tanımlayıcısında 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ıları grubu, dikey çizgi (|) karakteriyle ayrılmış bir dizi değer atamasıdır. Bu stil tanımlayıcı, bu işaretçi tanımlayıcı içindeki işaretçiler gösterilirken 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. size parametresi ayarlanmazsa işaretçi varsayılan (normal) boyutunda görünür.

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

  Şeffaflıkların (32 bit onaltılık renk değerleri kullanılarak belirtilir) yollar için 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 harfli alfanümerik karakter belirtir. (Büyük harf şartı, API'nin bu sürümünde yenidir.) Yalnızca varsayılan ve mid boyutlu işaretçilerin alphanumeric-character parametresini gösterebileceğini unutmayın. tiny ve small işaretleri, alfanümerik karakter gösteremez.

Not: Bu işaretçiler yerine kendi özel simgenizi kullanmak isteyebilirsiniz. (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 çıkış boyutunu elde etmek için 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 geçerli olur. Örneğin, işaretçi scale:2 olarak ayarlanmışsa ölçeklendirmeden sonra 4.096 pikselden küçük olduğu sürece maksimum boyut olan 4.096 pikselden büyük olabilir. Daha yüksek çözünürlüklü haritalar gösterirken işaretçi ölçeklendirmeyi harita ölçeklendirme ile birlikte kullanın.

İşaretçi konumları

Her işaretçi tanımlayıcı, 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 adresler 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. kullanıcı tarafından okunabilen adres dizeleri veya çoklu çizgiler) 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ığı sürece bu işaretçi, oluşturulan resimde görünmez. Ancak bu parametreler sağlanmazsa Maps Static API sunucusu, sağlanan işaretçileri içeren bir resmi otomatik olarak oluşturur. (Örtülü konumlandırma bölümüne bakın.)

Burada örnek bir işaretçi bildirimi gösterilmektedir. Bir stil grubu ve üç konum tanımladığımıza dikkat edin:

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ı stillere sahip 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 konumunda "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 simgeleri yerine kendi özel simgelerinizi kullanabilirsiniz. Özel simgeler, markers parametresindeki icon tanımlayıcısı kullanılarak belirtilir. Örneğin:

markers=icon:URLofIcon|markerLocation

icon değerini bir URL (URL kodlamalı olmalıdır) kullanarak belirtin. 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. Bağlantı noktası, simgenin belirtilen markers konumlarına göre nasıl yerleştirileceğini belirler. Varsayılan olarak, özel simgenin bağlantı noktası, simge resminin alt orta kısmıdır. icon ile birlikte anchor tanımlayıcısını kullanarak farklı bir bağlantı noktası belirtebilirsiniz. anchor değerini, simgenin x,y noktası (ör. 10,5) 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şaretli konumla sınırlı olduğunuz anlamına gelmez. Her benzersiz simge, haritanızdaki birden fazla markers konumla kullanılabilir.

Simge biçimi:

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

Özel simge örnekleri

1. örnek, özel simgeler oluşturur ve bağlantı noktalarını 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

2. örnek, 1. örnekle aynı özel simgeleri oluşturur ancak simge konumlarını sabitleyiciler kullanarak ayarlamaz ve varsayılan alt orta 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 görüntüsünün üzerine yerleştirilecek bir yolla bağlanan bir veya daha fazla konumdan oluşan bir grubu tanımlar. path parametresi, aşağıdaki biçimde değer atamaları (yol tanımlayıcıları) kümesini alır:

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

Her iki yol noktasının da dikey çizgi karakteri (|) kullanılarak birbirinden ayrıldığına dikkat edin. Hem stil bilgileri hem de nokta bilgileri dikey çizgi karakteriyle sınırlandırıldığından, stil bilgileri her yol tanımlayıcısında ilk sırada yer almalıdır. Maps Static API sunucusu, yol tanımlayıcıda bir konumla karşılaştıktan sonra diğer tüm yol parametrelerinin de konum olduğu varsayılır.

Yol stilleri

Yol stili tanımlayıcıları kümesi, dikey çizgi (|) karakteriyle ayrılmış bir dizi değer atamasıdır. Bu stil tanımlayı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. 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 ya da {black, brown, green, purple, yellow, blue, gray, orange, red, white} grubundan belirtir.

  32 bit 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. Şeffaflıkların yollarda desteklendiğini ancak işaretçiler için desteklenmediğini unutmayın.

• fillcolor: (isteğe bağlı), yolun çokgen bir alanı işaretlediğini ve bu alan içinde yer paylaşımı olarak kullanılacak dolgu rengini belirtir. Aşağıdaki konum grubu "kapalı" bir döngü olmak zorunda değildir. Maps Static API sunucusu, ilk ve son noktaları otomatik olarak birleştirir. Ancak, aynı başlangıç ve bitiş konumunu özellikle belirtmediğiniz sürece, doldurulan alanın dışındaki hiçbir konturun kapatılmayacağını unutmayın.
• geodesic: (isteğe bağlı), istenen yolun dünyanın eğriliğini takip eden bir jeodezik ç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
• Kalın düz beyaz çizgi: path=color:0xffffffff|weight:10

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

Yol noktaları

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

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

Bu path parametresinin ayrıntıları ş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 dizi kavşağın konum olarak iletildiği çokgen bir alan tanımlanmaktadır:

Bu path parametresinin ayrıntıları şunlardır:

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 kendisini görünmez, çokgen alanı ise% 15 opaklığa sahip olacak şekilde ayarladığımızı unutmayın.

Kodlanmış çoklu çizgiler

Bir dizi konum yerine, path konum bildiriminde enc: önekini kullanarak bir yolu kodlanmış çoklu çizgi olarak bildirebilirsiniz.

Aşağıdaki örnekte, Alaska Otoyolu'nun Dawson Creek, BC'den Delta Junction, AK'ye kadar olan rotası, kodlanmış bir çoklu ç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 çokgen alanları sınırlandırabilir.

Aşağıdaki örnekte, Brooklyn, NY için çokgen 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 kullanarak görünür konumları belirterek bir görüntü alanı belirtebilir. visible parametresi, Maps Static API hizmetine mevcut konumların görünür kalacağı şekilde bir harita oluşturma talimatı verir. (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 seviyesi belirtme ihtiyacını ortadan kaldırır.

Bir sonraki örnekte, Boston, MA merkezli, hem MIT'yi hem de Cambridge, MA'daki Harvard Meydanı'nı içeren bir harita istenmektedir:

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 konumlandırılması

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

İki veya daha fazla öğe sağlanırsa Maps Static API, uygun bir merkez ve yakınlaştırma seviyesi belirleyerek içerilen öğeler için geniş kenar boşlukları 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 boyutlarda 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 ihtiyacınız olduğu
2. Diğer Google Haritalar Platformu API'lerini (Maps JavaScript API, Maps Embed API, Android için Haritalar SDK'sı veya iOS için Haritalar SDK'sı) kullanmayı düşünüp düşünmediğiniz ve bu API'lerin ihtiyaçlarınızı neden karşılamadığı
3. Büyük boyutlu resimleri nasıl kullanacağınızı gösteren ekran görüntüleri, örnekler veya şablonlar.
4. Büyük boyutlu resimler için tahmini aylık kullanımınız.

Talebiniz, sağladığınız bilgilere göre incelenir ve kullanım alanınızın Google Haritalar Platformu Hizmet Şartları'na uygun olup olmadığı belirlenir.

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ı verebilir. Özellikle haritada bir şeylerin eksik olduğunu fark ederseniz uyarıları kontrol etmeniz gerekir. Yeni bir uygulama yayınlamadan önce uyarıları kontrol etmek de iyi bir fikirdir. Uyarılar HTTP başlığında göründüğünden hemen fark edilmeyebilir. Daha fazla bilgi için hatalar ve uyarılar kılavuzuna bakın.