Bing Haritalarını Taşıma Statik Harita API'si Alma

Bu makalede, Bing Haritalar Statik Harita Al API'sini Azure Haritalar Harita Al Statik Görüntü API'sine geçirme açıklanmaktadır. Azure Maps Statik Görüntü Alma API'si, kullanıcı tanımlı, dikdörtgen Yol, Uydu veya Trafik stili harita görüntüsü oluşturur ve sunar.

Önkoşullar

• Azure Hesabı
• Azure Haritalar hesabı
• Abonelik anahtarı veya Azure Haritalar ile başka bir Kimlik Doğrulaması biçimi

Önemli farklar

• Bing Haritalar Statik Harita API'si, Yol, Uydu/Havadan, Trafik, Streetside, Birds Eye ve Ordnance Survey harita stillerini sunar. Azure Maps Statik Görüntü API'si, Streetside, Birds Eye ve Ordnance Survey hariç aynı stilleri sunar.
• Bing Haritalar Statik Harita Al API'si konum girişi olarak koordinatları, sokak adresini veya yer adını kullanarak statik harita almayı destekler. Azure Haritalar Harita Al Statik Görüntü API'si yalnızca konum girişi olarak koordinatları destekler.
• Bing Haritalar Statik Harita Al API'si, yerel olarak bir sürüş, yürüyüş veya ulaşım yolunun statik haritasını almayı destekler. Azure Haritalar Harita Al Statik Görüntü API'si, yol haritası işlevselliğini yerel olarak sağlamaz.
• Bing Haritalar Statik Harita Al API'si PNG, JPEG ve GIF resim biçimlerinde statik haritalar sağlar. Azure Haritalar Harita Al Statik Görüntü API'si PNG ve JPEG görüntü biçimlerinde statik haritalar sağlar.
• Bing Haritalar Statik Harita Al API'si XML ve JSON yanıt biçimlerini destekler. Azure Haritalar Harita Al Statik Görüntü API'si yalnızca JSON yanıt biçimini destekler.
• Bing Haritalar Statik Harita Al API'si HTTP GET ve POST isteklerini destekler. Azure Haritalar Get Map Static Image API'si HTTP GET isteklerini destekler.
• Bing Haritalar Statik Harita Al API'si enlem ve boylam biçiminde koordinatları kullanır. Azure Haritalar Harita Statik Görüntü Alma API'si, GeoJSON'da tanımlandığı gibi boylam ve enlem biçiminde koordinatları kullanır.
• Bing Kurumsal Haritalar'dan farklı olarak Azure Haritalar, veri yerleşimini Avrupa (AB) veya Birleşik Devletler (ABD) coğrafi alanlarıyla (coğrafi bölge) sınırlamanıza olanak tanıyan coğrafi kapsam belirtmeyi destekleyen küresel bir hizmettir. Tüm istekler (giriş verileri dahil) yalnızca belirtilen coğrafi bölgede işlenir. Daha fazla bilgi için bkz. Azure Haritalar hizmet coğrafi kapsamı.

Güvenlik ve kimlik doğrulaması

Bing Kurumsal Haritalar yalnızca API anahtarı kimlik doğrulamasını destekler. Azure Haritalar abonelik anahtarı, Microsoft Entra Kimliği ve Paylaşılan Erişim İmzası (SAS) Belirteci gibi API çağrılarınızın kimliğini doğrulamanın birden çok yolunu destekler. tr-TR: Azure Haritalar'da güvenlik ve kimlik doğrulaması hakkında daha fazla bilgi için Azure Haritalar ile Kimlik Doğrulama ve Azure Haritalar Harita Statik Görüntüsü Alma dokümanındaki Güvenlik bölümüne bakın.

İstek parametreleri

Aşağıdaki tabloda Bing Haritalar Statik Harita Edin istek parametreleri ve Azure Haritalar'daki karşılıkları listeleniyor.

Bing Haritalar istek parametresi	Parametre Takma Adı	Azure Haritalar istek parametresi	Azure Haritalar’da gerekli	Azure Haritalar veri türü	Açıklama
merkezNokta		orta	True (bbox kullanılmıyorsa)	sayı[]	Bing Haritalar Statik Harita Al API'si koordinatların enlem ve boylam biçiminde olmasını gerektirirken Azure Haritalar Harita Al Statik Görüntü API'si GeoJSON biçiminde tanımlandığı gibi boylam ve enlem biçimi gerektirir.  longitude,latitude [-90, 90] aralığındadır. Not: Gerekli parametrelerden biri center veya bbox bunlardır. Birbirini dışlarlar.
kültür	c	dil	YANLIŞ	String	Azure Haritalar Harita Al Statik Görüntü API'sinde, arama sonuçlarının döndürülmesi gereken dildir ve Azure Haritalar istek üst bilgisinde belirtilir. Daha fazla bilgi için bkz . Desteklenen Diller.
Pinleri Düzenle	Dcl	Desteklenmiyor	Desteklenmez	Desteklenmez
dpi	klasör içeriğini listele (dir komutu)	Desteklenmez	Desteklenmez	Desteklenmez
drawCurve	dv	Yol	YANLIŞ	Dize
görüş alanı	Fov	Desteklenmez	Desteklenmez	Desteklenmez	Bing Haritalar'da bu parametre imagerySet Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey ve Streetside için kullanılır. Azure Haritalar bu harita stillerini desteklemez.
biçim	Fmt	format	DOĞRU	String	Bing Haritalar Statik Harita Al API'si PNG, JPEG ve GIF resim biçimlerinde statik haritalar sağlar. Azure Haritalar Harita Al Statik Görüntü API'si PNG ve JPEG görüntü biçimlerinde statik haritalar sağlar.
başlık		Desteklenmez	Desteklenmez	Desteklenmez	Bing Haritalar'da bu parametre imagerySet Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside için kullanılır. Azure Haritalar bu harita stillerini desteklemez.
vurgulaVarlık	o	Desteklenmez	Desteklenmez	Desteklenmez	Bing Haritalar Statik Harita Al API'sinde bu parametre, haritada yerel olarak görüntülenen konum girişinin (varlık) çokgenini almak için kullanılır. Azure Haritalar Harita Al Statik Görüntü API'si bu özelliği desteklemez, ancak Azure Haritalar ÇokGen Al API'sinden bir konumun (yerellik) çokgenini alabilir ve bunu statik haritada görüntüleyebilirsiniz.
görüntü kümesi		tilesetID	DOĞRU	TilesetId
haritaAlanı	ma	bbox	True (center kullanılmıyorsa)	sayı[]	İki boylam ve iki enlem ile tanımlanan sınırlayıcı kutu, dünya üzerindeki dikdörtgen bir alanın dört tarafını biçiminde minLon, minLat, maxLon, maxLattemsil eder.  Not: Gerekli parametrelerden biri center veya bbox bunlardır. Birbirini dışlarlar. bboxveya heightile width kullanılmamalıdır.
harita katmanı	ml	trafik katmanı	YANLIŞ	TrafficTilesetId	isteğe bağlı. Sağlanırsa TrafficLayer , ilgili trafik katmanına sahip harita görüntüsünü döndürür. Daha fazla bilgi için bkz . tilesetId.
mapSize	ms	yükseklik	DOĞRU	tamsayı int32
		genişlik
mapMetadata	mmd	Desteklenmez	Desteklenmez	Desteklenmez
yönlendirme	klasör içeriğini listele (dir komutu)	Desteklenmez	Desteklenmez	Desteklenmez	Bing Haritalar Statik Harita Al API'sinde bu parametre 'imagerySet' Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside için kullanılır. Azure Haritalar bu harita stillerini desteklemiyor
ton		Desteklenmez	Desteklenmez	Desteklenmez	Bing Haritalar Statik Harita Al API'sinde bu parametre 'imagerySet' Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside için kullanılır. Azure Haritalar bu harita stillerini desteklemiyor
raptiye	pp	pinler	YANLIŞ	String	Bing Haritalar Statik Harita Al API'sinde HTTP GET isteği 18 pin ve HTTP POST isteği statik harita başına 100 pin ile sınırlıdır. Azure Haritalar Harita Al Statik Görüntü API'si HTTP GET isteğinde statik harita başına pin sayısı sınırı yoktur. Ancak, statik eşlemede desteklenen pin sayısı, HTTP GET isteğinde desteklenen karakter sayısı üst sınırına bağlıdır. Azure Haritalar Harita Statik Görüntü API'sinin 'pins' parametresi hakkında daha fazla bilgi için URI Parametreleri bölümünde Pushpin desteğini inceleyin.
query		Desteklenmez	Desteklenmez	Desteklenmez	Azure Haritalar Harita Al Statik Görüntü API'si yalnızca konum girişi olarak koordinatları destekler, sokak adresi veya yer adını desteklemez. Sokak adresini veya yer adını koordinatlara dönüştürmek için Azure Haritalar Get Geocoding API'sini kullanın.
Rota Parametreleri: kaçının	Hiçbiri	Desteklenmez	Desteklenmez	Desteklenmez	Azure Haritalar Statik Görüntü Alma API'si, yol haritası işlevselliğini yerel olarak sağlamaz. Üzerinde yol yolu olan statik bir harita almak için, belirli bir yolun yol yolu koordinatlarını almak için Azure Haritalar Rota Yol Tariflerini Al veya Yol Tariflerini Gönder API'sini kullanın ve ardından yol yolu koordinatlarını statik harita üzerinde yer paylaşımlı yapmak için Azure Haritalar Harita Statik Görüntü API'sini drawCurve Al özelliğini kullanın.
Rota Parametreleri: ilkDönüştenÖncekiMesafe	dbft	Desteklenmez	Desteklenmez	Desteklenmez	Azure Haritalar Statik Görüntü API'si, yol haritası işlevselliğini doğrudan sağlamaz. Üzerinde bir rota yolu bulunan statik bir harita almak için, belirli bir rotanın yol yolu koordinatlarını almak üzere Azure Haritalar Çıkış Yolu Rota Talimatlarını Al veya Rota Talimatları Gönder API'sini kullanabilir ve ardından yol koordinatlarını statik harita üzerine yerleştirmek için Azure Haritalar Harita Statik Görüntü API'sini kullanabilirsiniz.
Yol Parametreleri: dateTime	Dt	Desteklenmez	Desteklenmez	Desteklenmez	Azure Maps Statik Görüntü API'si, rota haritası işlevselliğini yerel olarak sağlamaz. Üzerinde rota yolu olan statik bir harita almak için, belirli bir rotanın yol koordinatlarını almak için Azure Haritalar Rota Tariflerini Al veya Rota Tariflerini Gönder API'sini kullanabilir ve ardından rota koordinatlarını statik haritaya bindirmek için Azure Haritalar Statik Harita Görüntüsü Al özelliğini kullanabilirsiniz.
Yol Parametreleri: maxSolutions	maxSolns	Desteklenmez	Desteklenmez	Desteklenmez	Azure Haritalar Statik Görüntü Al API'si, rota haritası işlevselliğini yerel olarak sağlamaz. Üzerinde bir rota patikası olan statik bir harita almak için, belirli bir rotanın rota koordinatlarını elde etmek üzere Azure Haritalar Yol Tariflerini Al veya Yol Tariflerini Gönder API'sini kullanabilir ve ardından Azure Haritalar Harita Statik Görüntü API'sinin drawCurve özelliğini rota koordinatlarını statik haritanın üzerine eklemek için kullanabilirsiniz.
Rota Parametreleri: iyileştirme	optmz	Desteklenmez	Desteklenmez	Desteklenmez	Azure Haritalar Statik Görsel API'si, yol haritası işlevselliğini yerel olarak sağlamaz. Belirli bir rotanın yol koordinatlarını almak için Azure Haritalar Rota Talimatlarını Al veya Rota Talimatları Gönder API'sini kullanabilir ve ardından Azure Haritalar Statik Harita Görüntüsü Al API özelliğini kullanarak rota koordinatlarını statik harita üzerine yerleştirebilirsiniz.
Yol Parametreleri: ZamanTürü	TT	Desteklenmez	Desteklenmez	Desteklenmez	Azure Maps Statik Görüntü API'si, yol haritası işlevselliğini doğrudan sunmaz. Üzerinde rota yolu olan statik bir harita almak için, belirli bir rotanın rota yolu koordinatlarını almak için Azure Haritalar Rota Yol Tariflerini Al veya Rota Yol Tarifleri Gönder API'sini kullanabilir ve ardından bu koordinatları statik haritaya yerleştirmek için Azure Haritalar Statik Harita Görüntüsü Al özelliğini kullanabilirsiniz.
Rota Parametreleri: travelMode	Hiçbiri	Desteklenmez	Desteklenmez	Desteklenmez	Azure Maps Statik Görüntü API'si, yol haritası işlevselliğini doğrudan sunmaz. Üzerinde rota yolu olan statik bir harita almak için, belirli bir rotanın rota yolu koordinatlarını almak için Azure Haritalar Rota Yol Tariflerini Al veya Rota Yol Tarifleri Gönder API'sini kullanabilir ve ardından bu koordinatları statik haritaya yerleştirmek için Azure Haritalar Statik Harita Görüntüsü Al özelliğini kullanabilirsiniz.
Rota Parametreleri: waypoint.n	wp.n	Desteklenmez	Desteklenmez	Desteklenmez	Azure Maps Statik Görüntü API'si, yol haritası işlevselliğini doğrudan sunmaz. Üzerinde rota yolu olan statik bir harita almak için, belirli bir rotanın rota yolu koordinatlarını almak için Azure Haritalar Rota Yol Tariflerini Al veya Rota Yol Tarifleri Gönder API'sini kullanabilir ve ardından bu koordinatları statik haritaya yerleştirmek için Azure Haritalar Statik Harita Görüntüsü Al özelliğini kullanabilirsiniz.
stil	st	Desteklenmez	Desteklenmez	Desteklenmez
kullanıcı bölgesi	ur	görünüm	YANLIŞ	String	ISO 3166-1 Alfa-2 bölge/ülke kodunu temsil eden dize. Bu, jeopolitik ihtilaflı kenarlıkları ve etiketleri belirtilen kullanıcı bölgesiyle uyumlu olacak şekilde değiştirir. Varsayılan olarak, görünüm parametresi istekte tanımlanmasa bile "Otomatik" olarak ayarlanır. Daha fazla bilgi için bkz . Desteklenen Görünümler.
yakınlaştırma düzeyi		Yakınlaştırma	YANLIŞ	String	Haritanın istenen yakınlaştırma düzeyi. Yakınlaştırma değeri şu aralıkta olmalıdır: 0-20 (dahil). Varsayılan değer 12'dir.
vurgulaVarlık	o	Desteklenmez	Desteklenmez	Desteklenmez	Bing Haritalar Statik Harita Al API'sinde bu parametre, haritada yerel olarak görüntülenen konum girişinin (varlık) çokgenini almak için kullanılır. Azure Haritalar Harita Al Statik Görüntü API'si bu özelliği desteklemez, ancak Azure Haritalar ÇokGen Al API'sinden bir konumun (yerellik) çokgenini alabilir ve bunu statik haritada görüntüleyebilirsiniz.

Azure Haritalar Harita Statik Görüntü API'sini Alma isteği parametreleri hakkında daha fazla bilgi için bkz. URI Parametreleri.

İstek örnekleri

Bing Haritalar Statik Harita API'sini al örnek GET isteği:

https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/51.504810,-0.113629/15?mapSize=500,500&pp=51.504810,-0.113629;45&key={BingMapsKey}

Azure Haritalar Harita Statik Görüntü API'si GET isteği örneği:

https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=15&center=-0.113629,51.504810&height=500&Width=500&pins=default||-0.113629 51.504810||&subscription-key={Your-Azure-Maps-Subscription-key}

Yanıt örnekleri

Aşağıdaki ekran görüntüsünde, Bing Haritalar Statik Harita Al isteği yürütülürken HTTP yanıtının gövdesinde döndürülen içerik gösterilmektedir.

Aşağıdaki JSON örneği, bir Azure Haritalar Harita Statik Görüntüsünü Al isteği yürütülürken HTTP yanıtının gövdesinde dönüşü gösterir.

İşlem kullanımı

Bing Haritalar Statik Harita API'si gibi, Azure Haritalar Statik Harita Görüntü API'si de her istek için bir faturalanabilir işlem günlüğe kaydeder. Azure Haritalar işlemleri hakkında daha fazla bilgi için bkz. Azure Haritalar İşlemlerini Anlama.

Ek bilgi

• Bir raster harita üzerinde özel verileri görüntüleme

Destek

• Microsoft Soru-Cevap Forumu