Bing'i Geçirme Haritalar Konuma Göre Konum Bulma API'sini Geçirme

2024-05-17

Bu makalede, Bing Haritalar Konum Bul api'sini Nokta API'sine Azure Haritalar Ters Coğrafi Kodlama Al API'sine geçirme açıklanmaktadır. Azure Haritalar Get Reverse Geocoding API'si, boylam ve enlem koordinatlarını insan tarafından anlaşılabilen bir sokak adresine çevirmek için kullanılır.

Ö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 Konuma Göre Konum Bul API'si XML ve JSON yanıt biçimlerini destekler. Azure Haritalar Ters Coğrafi Kodlama API'sini almaGeoJSON yanıt biçimi.
Bing Haritalar Konuma Göre Konum Bul API'sinde enlem/boylam biçiminde koordinatlar kullanılır. Azure Haritalar Ters Coğrafi Kodlama API'sini Alma, tarafından tanımlanan boylam/enlem biçiminde koordinatları kullanırGeoJSON.
Bing Haritalar Point API'sinde Konum Bul API'sini Azure Haritalar Ters Coğrafi Kodlama Al API'si şu anda Çin, Japonya veya Güney Kore için adres veya sokak düzeyinde verileri desteklememektedir.
Bing Haritalar Point API'sine Göre Konum Bul'dan farklı olarak, Ters Coğrafi Kodlama api'sini Azure Haritalar, ISO 3166-1 Alfa-2 bölge/ülke kodunu temsil eden bir dize olan bir giriş parametresine sahiptirview. view Giriş parametresi jeopolitik ihtilaflı kenarlıkları ve etiketleri belirtilen kullanıcı bölgesiyle uyumlu olacak şekilde değiştirir. Daha fazla bilgi için bkz . URI Parametreleri.
Kurumsal için Bing Haritalar'den 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ı

Kurumsal için Bing 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. Azure Haritalar'da güvenlik ve kimlik doğrulaması hakkında daha fazla bilgi için Bkz. Azure Haritalar ile kimlik doğrulaması ve Coğrafi Kodlama Alma belgelerinin Azure Haritalar Güvenlik bölümü.

İstek parametreleri

Aşağıdaki tabloda, Bing Haritalar Konuma Noktaya Göre Konum Bul isteği parametreleri ve Azure Haritalar eşdeğeri listeleniyor:

Bing Haritalar istek parametresi	Bing Haritalar istek parametresi diğer adı	İstek parametresini Azure Haritalar	Azure Haritalar gerekli	Azure Haritalar veri türü	Açıklama
kültür	c	İstek Üst Bilgisi: Kabul Dili	False	Dize	Azure Haritalar Ters Coğrafi Kodlama API'sini Al'da, arama sonuçlarının döndürülmesi gereken dil budur. Bu, Azure Haritalar isteği üst bilgisinde belirtilir. Ayrıntılar için lütfen Desteklenen Diller'e bakın.
ekle	Dahil	Gerekli değil	Gerekli değil	Gerekli değil	Bing Haritalar Konuma Göre Konum Bul'da, yanıttaki konum sonucu için iki harfli bir ISO ülke kodu almak için 'include' giriş parametresi gereklidir. ters coğrafi kodlama API'sini Azure Haritalar iki harfli ISO ülke kodu varsayılan olarak döndürülür.
includeEntityTypes		resultTypes	False	query
includeNeighborhood	inclnb	Gerekli değil	Gerekli değil	Gerekli değil	Azure Haritalar Ters Coğrafi Kodlama API'sini Al bölümünde, varsa, mahalle bilgileri varsayılan olarak yanıtta döndürülür.
Nokta		koordinatlar	True	sayı[]	Bing Haritalar Konum Bulma Haritalar, istekteki ve yanıttaki koordinatlar enlem/boylam biçimindeyken, Azure Haritalar Ters Coğrafi Kodlama API'sini Al isteğin koordinatlarını gerektirir ve yanıttaki koordinatlar GeoJSON tarafından tanımlandığı gibi boylam/enlem biçimini kullanır.
userRegion	ur	görünüm	False	Dize	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ımlamamış olsanız bile "Otomatik" olarak ayarlanır. Ayrıntılar ve kullanılabilir Görünümleri görmek için lütfen Desteklenen Görünümler'e bakın.
verboseplacenames	vbpn	Desteklenmez	Desteklenmez	Desteklenmez	Azure Haritalar Ters Coğrafi Kodlama API'sini Alma yalnızca adminDistricts kısa adını (Florida yerine FL) döndürmeyi destekler.

Ters Coğrafi Kodlama API'sini Alma Azure Haritalar istek parametreleri hakkında daha fazla bilgi için bkz. URI Parametreleri.

İstek örnekleri

Bing Haritalar Konuma Göre Konum Bulma API isteği:

https://dev.virtualearth.net/REST/v1/Locations/48.830345,2.338166&key={BingMapsKey}

ters coğrafi kodlama API'sini alma isteğini Azure Haritalar:

http://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates=2.338166,48.830345&subscription-key={Your-Azure-Maps-Subscription-key}

Yanıt alanları

Aşağıdaki tabloda, Bing Haritalar Konuma Göre Konum Bul isteği ve Azure Haritalar eşdeğeri çalıştırılırken HTTP yanıtında görünebilecek alanlar listeleniyor:

Bing Haritalar yanıtı	Azure Haritalar yanıtı	Açıklama
address: addressLine (JSON) Adres: Adres Çizgisi (XML)	address: addressLine
adres: adminDistrict (JSON) Adres: Yönetici District (XML)	adres: adminDistricts
adres: adminDistrict2 (JSON) Adres: Yönetici District2 (XML)	adres: adminDistricts
adres: countryRegion (JSON) Adres: CountryRegion (XML)	adres: countryRegion
adres: countryRegionIso2 (JSON) Adres: CountryRegionIso2 (XML)	adres: countryRegion - iso
address: neighborhood (JSON) Adres: Mahalle (XML)	adres: mahalle
address: formattedAddress (JSON) Adres: FormattedAddress (XML)	adres: formattedAddress
adres: yerellik (JSON) Adres: Yerellik (XML)	adres: yerellik
adres: postalCode (JSON) Adres: Posta Kodu (XML)	address: postalCode
adres: Kesişim – baseStreet (JSON) Adres: Kesişim – BaseStreet (XML)	adres: kesişim -baseStreet
adres: Kesişim – secondaryStreet1 (JSON) Adres: Kesişim – SecondaryStreet1 (XML)	adres: kesişim - secondaryStreet1
adres: Kesişim – secondaryStreet2 (JSON) Adres: Kesişim – SecondaryStreet2 (XML)	adres: kesişim - secondaryStreet2
adres: Kesişim – kesişim Türü (JSON) Adres: Kesişim – Kesişim Türü (XML)	adres: kesişim - kesişim Türü
adres: Kesişim – displayName (JSON) Adres: Kesişim – DisplayName (XML)	adres: kesişim - displayName
bbox (JSON) Sınırlayıcı Kutusu (XML)	özellikler: bbox	Bing Haritalar Konuma Göre Konum Bul API'sinde yanıttaki koordinatlar enlem/boylam biçimindedir. Azure Haritalar Ters Coğrafi Kodlama API'sini Alma bölümünde yanıttaki koordinatlar GeoJSON tarafından tanımlandığı gibi boylam/enlem kullanır.
calculationMethod (JSON) CalculationMethod (XML)	özellikler: geocodePoints - hesaplamaMethod
güvenilirlik (JSON) Güvenilirlik (XML)	özellikler: güvenilirlik
entityType (JSON) EntityType (XML)	özellikler: tür
geocodePoints (JSON) GeocodePoint (XML)	özellikler: geocodePoints - koordinatlar
matchCodes (JSON) MatchCode (XML)	özellikler: matchCodes
name (JSON) Ad (XML)	Desteklenmez	`formattedAddress` Azure Haritalar, Bing Haritalar benzer bir değer sağlar `name`
point (JSON) Nokta (XML)	özellikler: koordinatlar	Bing Haritalar Konuma Göre Konum Bul API'sinde yanıttaki koordinatlar enlem/boylam biçimindedir. Azure Haritalar Ters Coğrafi Kodlama API'sini Alma bölümünde yanıttaki koordinatlar GeoJSON tarafından tanımlanan boylam/enlem biçimini kullanır.
usageTypes (JSON) usageType (XML)	özellikler: geocodePoints: usageTypes

Ters Coğrafi Kodlama API'sini Alma yanıt alanları Azure Haritalar hakkında daha fazla bilgi için bkz. Tanımlar.

Yanıt örnekleri

Aşağıdaki JSON örneği, Bing Haritalar Konuma Göre Konum Bul isteği yürütülürken HTTP yanıtının gövdesinde döndürülenleri gösterir:

{
    "authenticationResultCode": "ValidCredentials",
    "brandLogoUri": "https://dev.virtualearth.net/Branding/logo_powered_by.png",
    "copyright": "Copyright © 2024 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",
    "resourceSets": [
        {
            "estimatedTotal": 1,
            "resources": [
                {
                    "__type": "Location:http://schemas.microsoft.com/search/local/ws/rest/v1",
                    "bbox": [
                        48.826534682429326,
                        2.330334564829834,
                        48.83426011757068,
                        2.345980835170166
                    ],
                    "name": "30 Rue Cabanis, 75014 Paris, France",
                    "point": {
                        "type": "Point",
                        "coordinates": [
                            48.8303974,
                            2.3381577
                        ]
                    },
                    "address": {
                        "addressLine": "30 Rue Cabanis",
                        "adminDistrict": "Île-de-France",
                        "adminDistrict2": "Paris",
                        "countryRegion": "France",
                        "formattedAddress": "30 Rue Cabanis, 75014 Paris, France",
                        "intersection": {
                            "baseStreet": "Rue Cabanis",
                            "secondaryStreet1": "Villa de Lourcine",
                            "intersectionType": "Near",
                            "displayName": "Rue Cabanis and Villa de Lourcine"
                        },
                        "locality": "Paris",
                        "neighborhood": "14th Arrondissement",
                        "postalCode": "75014"
                    },
                    "confidence": "High",
                    "entityType": "Address",
                    "geocodePoints": [
                        {
                            "type": "Point",
                            "coordinates": [
                                48.8303974,
                                2.3381577
                            ],
                            "calculationMethod": "Rooftop",
                            "usageTypes": [
                                "Display"
                            ]
                        }
                    ],
                    "matchCodes": [
                        "Good"
                    ]
                }
            ]
        }
    ],
    "statusCode": 200,
    "statusDescription": "OK",
    "traceId": "c525b02f7f1e9e4ee3d7b81cce266671"

Aşağıdaki JSON örneği, ters coğrafi kodlama alma isteği Azure Haritalar yürütürken HTTP yanıtının gövdesinde döndürülenleri gösterir:

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    2.3381577,
                    48.8303974
                ]
            },
            "properties": {
                "geocodePoints": [
                    {
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                2.3381577,
                                48.8303974
                            ]
                        },
                        "calculationMethod": "Rooftop",
                        "usageTypes": [
                            "Display"
                        ]
                    }
                ],
                "address": {
                    "addressLine": "30 Rue Cabanis",
                    "adminDistricts": [
                        {
                            "shortName": "Île-de-France"
                        },
                        {
                            "shortName": "Paris"
                        }
                    ],
                    "countryRegion": {
                        "name": "France",
                        "iso": "FR"
                    },
                    "intersection": {
                        "baseStreet": "Rue Cabanis",
                        "displayName": "Rue Cabanis and Villa de Lourcine",
                        "intersectionType": "Near",
                        "secondaryStreet1": "Villa de Lourcine",
                        "secondaryStreet2": null
                    },
                    "locality": "Paris",
                    "neighborhood": "14th Arrondissement",
                    "postalCode": "75014",
                    "formattedAddress": "30 Rue Cabanis, 75014 Paris, France"
                },
                "confidence": "High",
                "matchCodes": [
                    "Good"
                ],
                "type": "Address"
            },
            "bbox": [
                2.330334564829834,
                48.826534682429326,
                2.345980835170166,
                48.83426011757068
            ]
        }
    ]
}

İşlem kullanımı

Bing Haritalar Konum Bul Azure Haritalar Ters Coğrafi Kodlama API'sini Al gibi istek başına 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

Azure Haritalar Ters Coğrafi Kodlama Toplu İş API'sini Alma: Azure Haritalar Ters Coğrafi Kodlama API'sine tek bir istekte bir grup sorgu göndermek için kullanın.

Destek

Microsoft Soru-Cevap Forumu