Bing Haritalar Coğrafi Kod Veri Akışı API'sini geçirme

2024-05-17

Bu makalede, Bing Haritalar Geocode Veri Akışı API'sini Coğrafi Kodlama Toplu İşlemi ve Ters Coğrafi Kodlama Toplu İş API'sine Azure Haritalar geçirme işlemi açıklanmaktadır. Azure Haritalar Geocoding Batch API'si, tek bir API çağrısıyla toplu iş modundaki bir yerin sokak adresinin veya adının enlem ve boylam koordinatlarını almak için kullanılır. Azure Haritalar Coğrafi Kodlama Batch API'si, tek bir istekte Azure Haritalar Geocoding API'sine toplu sorgular gönderen bir HTTP POST isteğidir. Azure Haritalar Ters Coğrafi Kodlama Batch API'si, enlem ve boylam koordinatlarını insan tarafından anlaşılabilen bir sokak adresine çevirmek için kullanılır. Azure Haritalar Ters Coğrafi Kodlama Toplu İş API'si, Azure Haritalar Ters Coğrafi Kodlama API'sine tek bir istekte toplu sorgular gönderen bir HTTP POST isteğidir.

Ö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 Geocode Veri Akışı API'si, aynı API içinde ileri ve geri toplu iş coğrafi kodlamasını destekler. Azure Haritalar ileri ve ters coğrafi kodlama için ayrı API'leri vardır.
Bing Haritalar Coğrafi Kod Veri Akışı API'sinde konum verilerinizin XML veya metin (csv, kanal veya sekmeyle ayrılmış) veri dosyası olarak yüklenmesi gerekir. Azure Haritalar Geocoding Batch ve Reverse Geocoding Batch API'sinde veri dosyası karşıya yükleme yaklaşımı değil, isteğin gövdesinde GeoJSON biçiminde konum verileri içeren bir HTTP POST isteği kullanılır.
Bing Haritalar Geocode Veri Akışı API'si karşıya yükleme başına en fazla 200.000 varlığı destekler. Azure Haritalar Geocoding Batch ve Ters Coğrafi Kodlama Batch API'si zaman uyumlu istekte 100'e kadar toplu sorguyu ve zaman uyumsuz istekte en fazla 200.000 sorguyu destekler.
Bing Haritalar Coğrafi Kod Veri Akışı API'sinin durumu ve indirme sonuçlarını almak için ilk veri yükleme işleminden sonra bir dizi API çağrısı gerekir. Azure Haritalar Coğrafi Kodlama Toplu İşlemi ve Ters Coğrafi Kodlama Batch API'sinin zaman uyumlu isteği ek API çağrıları gerektirmez. Zaman uyumsuz istek, toplu işlem durumunu almak ve sonuçları indirmek için ek çağrılar gerektirir.
Bing Haritalar Coğrafi Kod Veri Akışı koordinatları enlem/boylam biçimindedir. Azure Haritalar Geocoding Batch ve Reverse Geocoding Batch API koordinatları boylam/enlem biçimindedir (GeoJSON biçiminde olması nedeniyle).
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 Id veya 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 güvenlik ve kimlik doğrulaması hakkında daha fazla bilgi için Azure Haritalar ile kimlik doğrulaması ve Azure Haritalar Geocoding Batch belgelerinin Güvenlik bölümüne bakın.

İstek parametreleri

Aşağıdaki tabloda Bing Haritalar Coğrafi Kod Veri Akışı isteği parametreleri ve Azure Haritalar eşdeğeri listeleniyor:

Bing Haritalar Parametresi	Azure Haritalar Parametresi	Açıklama
dataLocation	Gerekli değil
Giriş	Gerekli değil	Bing Haritalar Coğrafi Kod Veri Akışı API'si, toplu coğrafi kodlama giriş veri dosyası için XML ve Metin (csv, sekme ve kanal sınırlandırılmış) biçimini destekler. Azure Haritalar, HTTP POST isteğindeki toplu coğrafi kodlama giriş verileri için JSON biçimini destekler.
Çıkış	Gerekli değil	Bing Haritalar Coğrafi Kod Veri Akışı API'si toplu coğrafi kod çıktı verileri için JSON ve XML'yi destekler. Azure Haritalar toplu coğrafi kodlama çıkış verileri için JSON biçimini destekler.

Azure Haritalar URI parametreleri ve istek gövdesi hakkında daha fazla bilgi için Azure Haritalar Geocoding Batch ve Reverse Geocoding Batch belgelerine bakın.

Bing Haritalar Veri Şeması 2.0 giriş ve çıkış karşılaştırması Azure Haritalar Geocode Batch ve Ters Coğrafi Kod Toplu İş API'sine:

Bing Haritalar Alanı	Bing Haritalar İşlemi	Azure Haritalar Alanı	Azure Haritalar veri türü	Açıklama
Address.AddressLine	Coğrafi Kod İsteği Coğrafi Kod Yanıtı	addressLine	Dize
Adres. Yönetici District	Coğrafi Kod İsteği Coğrafi Kod Yanıtı	adminDistrict	Dize
Address.CountryRegion	Coğrafi Kod İsteği Coğrafi Kod Yanıtı	Countryregion	Dize
Adres.Bölge	Coğrafi Kod İsteği	adminDistrict2	Dize
Address.FormattedAddress	Coğrafi Kod Yanıtı
Address.Landmark	Coğrafi Kod Yanıtı	Desteklenmiyor	Desteklenmiyor
Address.Locality	Coğrafi Kod İsteği Coğrafi Kod Yanıtı	Yer	Dize
Adres.Mahalle	Coğrafi Kod Yanıtı	Mahalle	Dize
Address.PostalCode	Coğrafi Kod İsteği Coğrafi Kod Yanıtı	Postakodu	Dize
Adres.PostalTown	Coğrafi Kod İsteği	adminDistrict3
BoundingBox.SouthLatitude, BoundingBox.EastLongitude, BoundingBox.NorthLatitude, BoundingBox.EastLongitude	Coğrafi Kod Yanıtı	bbox	sayı[]	kullanılan Azure Haritalar projeksiyon EPSG:3857'dir. Daha fazla bilgi için bkz . RFC 7946.
Güven	Coğrafi Kod Yanıtı	Güven	ConfidenceEnum	Daha fazla bilgi için Azure Haritalar Geocoding Batch ve Reverse Geocoding Batch API belgelerine bakın.
ConfidenceFilter.MinimumConfidence	Coğrafi Kod İsteği Ters Coğrafi Kod İsteği	Desteklenmiyor	Desteklenmiyor
Kültür	Coğrafi Kod İsteği Ters Coğrafi Kod İsteği	İstek Üst Bilgisi: Kabul Dili	Dize	Daha fazla bilgi için bkz. Azure Haritalar Desteklenen Diller.
Entitytype	Coğrafi Kod Yanıtı	Türü	Dize	Daha fazla bilgi için Azure Haritalar Geocoding Batch ve Reverse Geocoding Batch API belgelerine bakın.
Faultreason	Coğrafi Kod Yanıtı	Desteklenmiyor	Desteklenmez
GeocodeEntity	XML kapsayıcısı	Gerekli değil	Gerekli değil
GeocodeFeed	XML kapsayıcısı	Gerekli değil	Gerekli değil
GeocodePoint	Coğrafi Kod Yanıtı	geocodePoint'ler	GeocodePoints[]	Daha fazla bilgi için Azure Haritalar Geocoding Batch ve Reverse Geocoding Batch API belgelerine bakın.
GeocodeRequest	XML kapsayıcısı	Gerekli değil	Gerekli değil	Azure Haritalar ileriye doğru coğrafi kodlama ve ters coğrafi kodlama için ayrı API'ler vardır.
Kimliği	Coğrafi Kod İsteği	Gerekli değil	Gerekli değil
IncludeEntityTypes	Coğrafi Kod İsteği Ters Coğrafi Kod İsteği	Desteklenmiyor	Desteklenmiyor
IncludeNeighborhood	Coğrafi Kod İsteği Ters Coğrafi Kod İsteği	Gerekli değil	Gerekli değil	Azure Haritalar'da, varsa, mahalle bilgileri varsayılan olarak yanıtta döndürülür.
IncludeQueryParse	Coğrafi Kod İsteği	Desteklenmiyor	Desteklenmiyor
Location.Latitude Location.Longitude	Ters Coğrafi Kod İsteği	Koordinat -ları	sayı[]	Ters coğrafi kodlama yapmak için Azure Haritalar Ters Coğrafi Kodlama Batch API'sini kullanıyorsanız giriş olarak gereklidir.
MatchCodes	Coğrafi Kod Yanıtı	matchCodes	MatchCodesEnum	Daha fazla bilgi için Azure Haritalar Geocoding Batch ve Reverse Geocoding Batch API belgelerine bakın.
MaxResults	Coğrafi Kod İsteği Ters Coğrafi Kod İsteği	Sayfanın Üstü	integer int32	Azure Haritalar, döndürülen yanıt sayısı üst sınırıdır. Varsayılan değer 5, en az 1 ve en fazla 20'dir.
Adı	Coğrafi Kod Yanıtı	Desteklenmiyor	Desteklenmiyor
Point.Latitude, Point.Longitude	Coğrafi Kod Yanıtı	Koordinat -ları	sayı[]	Bing Haritalar koordinatları enlem/boylam biçiminde döndürür. Azure Haritalar koordinatları boylam/enlem biçiminde döndürür (GeoJSON biçiminde olması nedeniyle).
Sorgu	Coğrafi Kod İsteği	Sorgu	Dize
QueryParseValue	Coğrafi Kod Yanıtı	Desteklenmiyor	Desteklenmez
ReverseGeocodeRequest	XML kapsayıcısı	Gerekli değil	Gerekli değil	Azure Haritalar ileriye doğru coğrafi kodlama ve ters coğrafi kodlama için ayrı API'ler vardır.
Statuscode	Coğrafi Kod Yanıtı	Desteklenmiyor	Desteklenmiyor
StrictMatch	Coğrafi Kod İsteği	Desteklenmiyor	Desteklenmiyor
TraceId	Coğrafi Kod Yanıtı	Desteklenmiyor	Desteklenmiyor
Sürüm		Gerekli değil	Gerekli değil

Azure Haritalar Geocoding Batch yanıt alanları hakkında daha fazla bilgi için yanıt Tanımları'na bakın.

İstek örnekleri

Bing Haritalar Coğrafi Kod Veri Akışı API'si isteği:

http://spatial.virtualearth.net/REST/v1/Dataflows/Geocode?input=xml&key={BingMapsKey}

Coğrafi Kod Veri Akışının 2.0 sürümü için örnek giriş ve çıkış verilerini gösteren örnekler için bkz . Coğrafi Kod Veri Akışı Örnek Giriş ve Çıkış Verileri Sürüm 2.0.

Coğrafi Kodlama Batch API'sini Azure Haritalar isteği:

POST https://atlas.microsoft.com/geocode:batch?api-version=2023-06-01&subscription-key={Your-Azure-Maps-Subscription-key}

Coğrafi kodlama sorgularını göndermek için, isteğin gövdesinin JSON biçiminde batchItems dizisini ve application/json olarak ayarlanmış İçerik Türü üst bilgisini içerdiği bir HTTP POST isteği kullanın.

Aşağıdaki JSON, bir konum yapılandırılmamış biçimde ve bir konum yapılandırılmış biçimde olmak üzere iki coğrafi kodlama sorgusu içeren bir örnek isteği gösterir:

{ 
  "batchItems": [ 
    { 
      "addressLine": "One, Microsoft Way, Redmond, WA 98052", 
      "top": 2 
    }, 
    { 
      "addressLine": "Pike Pl", 
      "adminDistrict": "WA", 
      "locality": "Seattle", 
      "top": 3 
    } 
  ] 
}

Örnek Azure Haritalar Ters Coğrafi Kodlama Toplu İş API'si isteği:

POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01&subscription-key={Your-Azure-Maps-Subscription-key}

Ters coğrafi kodlama sorgularını göndermek için, isteğin gövdesinin JSON biçiminde bir batchItems dizisi içerdiği ve İçerik Türü üst bilgisinin application/json olarak ayarlandığı bir HTTP POST isteği kullanın.

Aşağıdaki JSON, iki ters coğrafi kodlama sorgusu içeren örnek bir isteği gösterir:

{ 
  "batchItems": [ 
    { 
      "coordinates": [ 
        -122.128275, 
        47.639429 
      ], 
      "resultTypes": [ 
        "Address", 
        "PopulatedPlace" 
      ], 
      "optionalId": "4C3681A6C8AA4AC3441412763A2A25C81444DC8B" 
    }, 
    { 
      "coordinates": [ 
        -122.341979399674, 
        47.6095253501216 
      ], 
      "optionalId": "6M9W39P12SNHGAIZ4JQ7F57NWJLV2BRYEQRD7OH7" 
    } 
  ] 
}

Yanıt örnekleri

Bing Haritalar Geocode Veri Akışı toplu işlemi tamamlanan iş durumu tarafından gösterildiği gibi başarıyla işlendiğinde coğrafi kod iş sonuçlarını indirme url'si sağlanır. Başarılı bir Bing Haritalar Coğrafi Kod Veri Akışı çıkışı örneği için Bing Haritalar belgelerindeki Coğrafi Kodlama Veri Akışı Örnek Giriş ve Çıkış Verileri Sürüm 2.0'a bakın.

Aşağıdaki örnekte, Azure Haritalar Coğrafi Kodlama Batch API'sinin isteği yürütülürken HTTP yanıtının gövdesinde döndürülenler gösterilmektedir:

{ 
  "summary": { 
    "successfulRequests": 1, 
    "totalRequests": 2 
  }, 
  "batchItems": [ 
    {
      "type": "FeatureCollection", 
      "features": [ 
        { 
          "type": "Feature", 
          "properties": { 
            "type": "Address", 
            "confidence": "High", 
            "matchCodes": [ 
              "Good" 
            ], 
            "address": { 
              "locality": "Redmond", 
              "adminDistricts": [ 
                { 
                  "shortName": "WA" 
                }, 
                { 
                  "shortName": "King" 
                } 
              ], 
              "countryRegion": { 
                "ISO": "US", 
                "name": "United States" 
              }, 
              "postalCode": "98052", 
              "formattedAddress": "1 Microsoft Way, Redmond, WA 98052", 
              "addressLine": "1 Microsoft Way" 
            }, 
            "geocodePoints": [ 
              { 
                "geometry": { 
                  "type": "Point", 
                  "coordinates": [ 
                    -122.128275, 
                    47.639429 
                  ] 
                }, 
                "calculationMethod": "Rooftop", 
                "usageTypes": [ 
                  "Display", 
                  "Route" 
                ] 
              }, 
              { 
                "geometry": { 
                  "type": "Point", 
                  "coordinates": [ 
                    -122.127028, 
                    47.638545 
                  ] 
                }, 
                "calculationMethod": "Rooftop", 
                "usageTypes": [ 
                  "Route" 
                ] 
              } 
            ] 
          }, 
          "geometry": { 
            "type": "Point", 
            "coordinates": [ 
              -122.128275, 
              47.639429 
            ] 
          }, 
          "bbox": [ 
            -122.1359181505759, 
            47.63556628242932, 
            -122.1206318494241, 
            47.643291717570676 
          ] 
        } 
      ]
    },
    {
      "error": {
        "code": "Conflicting Parameters",
        "message": "When 'query' is present, only the following parameters are valid: 'bbox, location, view, top'. 'addressLine' was passed"
      }
    }
  ]
}

Aşağıdaki örnekte, Azure Haritalar Ters Coğrafi Kodlama Toplu İş API'sinin isteği yürütülürken HTTP yanıtının gövdesinde neler döndürülür gösterilmektedir:

{ 
    "batchItems": [ 
        { 
            "type": "FeatureCollection", 
            "features": [ 
                { 
                    "type": "Feature", 
                    "geometry": { 
                        "type": "Point", 
                        "coordinates": [ 
                            -122.1294081, 
                            47.6391325 
                        ] 
                    }, 
                    "properties": { 
                        "geocodePoints": [ 
                            { 
                                "geometry": { 
                                    "type": "Point", 
                                    "coordinates": [ 
                                        -122.1294081, 
                                        47.6391325 
                                    ] 
                                }, 
                                "calculationMethod": "Rooftop", 
                                "usageTypes": [ 
                                    "Display" 
                                ] 
                            } 
                        ], 
                        "address": { 
                            "addressLine": "15770 NE 31st St", 
                            "adminDistricts": [ 
                                { 
                                    "shortName": "WA" 
                                }, 
                                { 
                                    "shortName": "King Co." 
                                } 
                            ], 
                            "countryRegion": { 
                                "name": "United States", 
                                "iso": "US" 
                            }, 
                            "locality": "Redmond", 
                            "neighborhood": "Overlake", 
                            "postalCode": "98052", 
                            "formattedAddress": "15770 NE 31st St, Redmond, WA 98052, United States" 
                        }, 
                        "confidence": "High", 
                        "matchCodes": [ 
                            "Good" 
                        ], 
                        "type": "Address" 
                    }, 
                    "bbox": [ 
                        -122.13705120720665, 
                        47.635269782429326, 
                        -122.12176499279336, 
                        47.64299521757068 
                    ] 
                } 
            ] 
        }, 
        { 
            "type": "FeatureCollection", 
            "features": [ 
                { 
                    "type": "Feature", 
                    "geometry": { 
                        "type": "Point", 
                        "coordinates": [ 
                            -122.341979399674, 
                            47.6095253501216 
                        ] 
                    }, 
                    "properties": { 
                        "geocodePoints": [ 
                            { 
                                "geometry": { 
                                    "type": "Point", 
                                    "coordinates": [ 
                                        -122.341979399674, 
                                        47.6095253501216 
                                    ] 
                                }, 
                                "calculationMethod": "Interpolation", 
                                "usageTypes": [ 
                                    "Display", 
                                    "Route" 
                                ] 
                            } 
                        ], 
                        "address": { 
                            "addressLine": "1736 Pike Pl", 
                            "adminDistricts": [ 
                                { 
                                    "shortName": "WA"
                                }, 
                                { 
                                    "shortName": "King Co." 
                                } 
                            ], 
                            "countryRegion": { 
                                "name": "United States", 
                                "iso": "US" 
                            }, 
                            "intersection": { 
                                "baseStreet": "Pike Pl", 
                                "displayName": "Pike Pl and Stewart St", 
                                "intersectionType": "Near", 
                                "secondaryStreet1": "Stewart St", 
                                "secondaryStreet2": null 
                            }, 
                            "locality": "Seattle", 
                            "neighborhood": "Downtown Seattle", 
                            "postalCode": "98101", 
                            "formattedAddress": "1736 Pike Pl, Seattle, WA 98101, United States" 
                        }, 
                        "confidence": "Medium", 
                        "matchCodes": [ 
                            "Good" 
                        ], 
                        "type": "Address" 
                    }, 
                    "bbox": [ 
                        -122.34961817972945, 
                        47.605662632550924, 
                        -122.33434061961856, 
                        47.61338806769228 
                    ] 
                } 
            ] 
        } 
    ], 
    "summary": { 
        "successfulRequests": 2, 
        "totalRequests": 2 
    } 
}

İşlem kullanımı

Bing Haritalar Coğrafi Kod Veri Akışı API'sine benzer şekilde, Coğrafi Kodlama Batch ve Ters Coğrafi Kodlama Toplu İş API'leri Azure Haritalar coğrafi olarak kodlanmış öğe başına bir faturalanabilir işlem günlüğe kaydeder. Örneğin, toplu iş isteğinde coğrafi olarak kodlanmış 100 konum, 100 faturalanabilir işlemle sonuçlanır. Azure Haritalar işlemleri hakkında daha fazla bilgi için bkz. Azure Haritalar İşlemlerini Anlama.

Ek bilgi

Daha fazla Azure Haritalar Coğrafi Kodlama API'leri

Coğrafi Kodlamayı Alma: Bir sokak adresinin veya bir yerin adının enlem ve boylam koordinatlarını almak için kullanın.
Ters Coğrafi Kodlamayı Alma: Enlem ve boylam koordinatlarından bir sokak adresi ve konum bilgisi almak için kullanın.

Destek

Microsoft Soru-Cevap Forumu