Search - Get Reverse Geocoding Batch

Başvuru

Service:: Maps

API Version:: 2023-06-01

Tek bir istekte Ters Coğrafi Kodlama API'sine bir grup sorgu göndermek için kullanın.

Get Reverse Geocoding Batch API, tek bir istek kullanarak Ters Coğrafi Kodlama API'sine en fazla 100 sorgu içeren toplu işlemler gönderen bir HTTP POST isteğidir.

Zaman Uyumlu Toplu İş İsteği Gönder

Basit toplu istekler için Zaman Uyumlu API önerilir. Hizmet bir istek aldığında, toplu iş öğeleri hesaplanır hesaplanmaz yanıt verir ve sonuçları daha sonra alma imkanı olmaz. İstek 60 saniyeden uzun sürerse Zaman Uyumlu API bir zaman aşımı hatası (408 yanıtı) döndürür. Bu API için toplu iş öğelerinin sayısı 100 ile sınırlıdır.

POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01

Toplu İstek için POST Gövdesi

Ters coğrafi kodlama sorgularını göndermek için istek gövdesinin diziyi batchItemsjson biçiminde içereceği ve Content-Type üst bilginin olarak ayarlanacağı application/jsonbir POST istek kullanacaksınız. Aşağıda 2 ters coğrafi kodlama sorgusu içeren bir örnek istek gövdesi verilmişti:

{
  "batchItems": [
    {
      "coordinates": [-122.128275, 47.639429],
      "resultTypes": ["Address", "PopulatedPlace"]
    },
    {
      "coordinates": [-122.341979399674, 47.6095253501216]
    }
  ]
}

Ters coğrafi kodlama batchItem nesnesi desteklenen ters coğrafi kodlamaURI parametrelerinden herhangi birini kabul edebilir.

Toplu işlem en az 1 sorgu içermelidir.

Toplu Yanıt Modeli

Toplu yanıt, özgün toplu iş isteğinin totalRequests parçası olan öğesini ve successfulRequests örneğin başarıyla yürütülen sorguları gösteren bir summary bileşen içerir. Toplu yanıt, toplu iş isteğindeki her sorgu için bir yanıt içeren bir dizi de içerir batchItems . , batchItems sonuçları, özgün sorguların toplu iş isteğinde gönderildiği sırayla tam olarak aynı sırada içerir. Her öğe aşağıdaki türlerden biridir:

GeocodingResponse - Sorgu başarıyla tamamlandıysa.
Error - Sorgu başarısız olduysa. Yanıt, bu durumda bir code ve message içerir.

POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
api-version	query	True	string	Azure Haritalar API'sinin sürüm numarası.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-id		string	Hangi hesabın Azure AD güvenlik modeliyle birlikte kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'de Azure AD güvenliği kullanmak için rehberlik için aşağıdaki makalelere bakın.
Accept-Language		string	Arama sonuçlarının döndürülmesi gereken dil. Ayrıntılar için lütfen Desteklenen Diller'e bakın.

Name

Gerekli

Tür

Description

x-ms-client-id

string

Hangi hesabın Azure AD güvenlik modeliyle birlikte kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'de Azure AD güvenliği kullanmak için rehberlik için aşağıdaki makalelere bakın.

Accept-Language

string

Arama sonuçlarının döndürülmesi gereken dil.

Ayrıntılar için lütfen Desteklenen Diller'e bakın.

İstek Gövdesi

Name	Tür	Description
batchItems	ReverseGeocodingBatchRequestItem[]	İşlenmek üzere sorguların listesi.

Yanıtlar

Name	Tür	Description
200 OK	GeocodingBatchResponse	Tamam
Other Status Codes	ErrorResponse	Beklenmeyen bir hata oluştu.

Güvenlik

AADToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim denetimiyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağa erişim tanımlamak için kullanılır. Tüm kullanıcılara, gruplara veya hizmet sorumlularına yerleşik bir rol veya Azure Haritalar REST API'leri için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.

Senaryoları uygulamak için kimlik doğrulama kavramlarını görüntülemenizi öneririz. Özetle, bu güvenlik tanımı belirli API'ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulamaları modellemek için bir çözüm sağlar.

Not

Bu güvenlik tanımı, uygulamanın erişim istediği Azure Haritalar kaynağı belirtmek için üst bilgi kullanımını x-ms-client-idgerektirir. Bu, Haritalar yönetim API'sinden alınabilir.
Authorization URL, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Microsoft Entra ID yapılandırmaları vardır.
Azure rol tabanlı erişim denetimi Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzleminden yapılandırılır.
Azure Haritalar Web SDK'sının kullanımı, bir uygulamanın birden çok kullanım örneği için yapılandırma tabanlı kurulumuna olanak tanır.
Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformu genel bakış.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Bu, Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağı oluştururken sağlanan paylaşılan bir anahtardır.

Bu anahtarla, tüm uygulamalar tüm REST API'lerine erişim yetkisine sahip olur. Başka bir deyişle, bunlar şu anda verildikleri hesabın ana anahtarları olarak kabul edilebilir.

Genel kullanıma sunulan uygulamalar için önerimiz, bu anahtarın güvenli bir şekilde depolanabildiği Azure Haritalar REST API'lerinin sunucudan sunucuya erişiminin kullanılmasıdır.

Type: apiKey
In: header

SAS Token

Bu paylaşılan erişim imzası belirteci, Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağındaki Sas Listeleme işleminden oluşturulur.

Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirtecin kullanım süresi, oranı ve bölgelerine yönelik ayrıntılı denetim ile erişim yetkisine sahip olur. Başka bir deyişle SAS Belirteci, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde denetlemesine izin vermek için kullanılabilir.

Herkese açık uygulamalar için önerimiz, uygunsuz işlemeyi sınırlamak ve SAS Belirtecini düzenli olarak yenilemek için Harita hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmanızdır.

Type: apiKey
In: header

Örnekler

A Reverse Geocoding Batch API call containing 2 Reverse Geocoding queries

Sample Request

HTTP

POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01

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

Sample Response

Status code:: 200

{
  "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
          ]
        }
      ]
    },
    {
      "optionalId": "3K5O3Y832J2YV6D7XNGUSM4ECCUGDEFN172CJQNN",
      "error": {
        "code": "400 Bad Request",
        "message": "The provided coordinates in query are invalid, out of range, or not in the expected format"
      }
    }
  ]
}

Tanımlar

Name	Description
Address	Sonucun adresi
AdminDistricts	Bir adresin ülke veya bölgedeki alt bölüm adı. Bu öğe genellikle birinci sıra yönetim alt bölümü olarak değerlendirilir, ancak bazı durumlarda bir ülke, bağımlılık veya bölgedeki ikinci, üçüncü veya dördüncü sıra alt bölümünü de içerir.
CalculationMethodEnum	Coğrafi kod noktasını hesaplamak için kullanılan yöntem.
ConfidenceEnum	Coğrafi olarak kodlanmış konum sonucunun eşleşmesi güven düzeyi. Eşleşme hakkında daha fazla bilgi için bu değeri eşleştirme koduyla birlikte kullanın. Coğrafi olarak kodlanmış bir konumun güvenilirliği, coğrafi olarak kodlanmış konumun ve belirtildiyse kullanıcının konumunun göreli önemi de dahil olmak üzere birçok faktöre dayanır.
CountryRegion
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
FeatureCollectionEnum	FeatureCollection nesnesinin türü FeatureCollection olmalıdır.
FeaturesItem
FeatureTypeEnum	Bir özelliğin türü Özellik olmalıdır.
GeocodePoints	Hesaplanma şekline ve önerilen kullanımlarına göre farklılık gösteren bir coğrafi kod noktaları koleksiyonu.
GeocodingBatchResponse	Bu nesne başarılı bir Coğrafi Kodlama Batch hizmeti çağrısından döndürülür.
GeocodingBatchResponseItem
GeoJsonPoint	Geçerli `GeoJSON Point` bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
Intersection	Sonucun adresi.
MatchCodesEnum	Yanıttaki her konum için coğrafi kodlama düzeyini temsil eden bir veya daha fazla kod değeri eşleştirin. Örneğin, eşleme kodları `Good` içeren coğrafi olarak kodlanmış bir konum ve `Ambiguous` konum bilgileri için birden fazla coğrafi kod konumu bulunduğu ve coğrafi kod hizmetinin eşleşme bulmak için hiyerarşide arama yapmadığı anlamına gelir. Benzer şekilde, eşleme kodları `Ambiguous` ve `UpHierarchy` ile coğrafi olarak kodlanmış bir konum, sağlanan tüm konum bilgileriyle eşleşen bir coğrafi kod konumunun bulunamadığını gösterir, bu nedenle coğrafi kod hizmetinin hiyerarşiyi yukarı araması gerekiyordu ve bu düzeyde birden çok eşleşme buldu. Ve sonucunun `AmbiguousUpHierarchy` bir örneği, tam adres bilgilerini sağladığınız, ancak coğrafi kod hizmetinin sokak adresi için bir eşleşme bulamadığı ve bunun yerine birden fazla RoadBlock değeri için bilgi döndürdüğü durumdur. Olası değerler şunlardır: `Good`: Konumda yalnızca bir eşleşme vardır veya döndürülen tüm eşleşmeler güçlü eşleşmeler olarak kabul edilir. Örneğin, New York sorgusu birkaç İyi eşleşme döndürür. `Ambiguous`: Konum, olası eşleşme kümelerinden biridir. Örneğin, 128 Ana Cadde sokak adresini sorguladığınızda, hangi seçeneğin seçileceğini belirlemek için yeterli bilgi olmadığından, yanıt 128 Kuzey Ana Cadde ve 128 Güney Ana Cadde için iki konum döndürebilir. `UpHierarchy`: Konum, coğrafi hiyerarşide yukarı taşımayı temsil eder. Konum isteği için eşleşme bulunamadığında bu durum oluşur, bu nedenle daha az kesin bir sonuç döndürülür. Örneğin, istenen adres için bir eşleşme bulunamazsa, RoadBlock varlık türüyle eşleşme kodu `UpHierarchy` döndürülebilir.
Properties
ResultTypeEnum	Yanıtta olmasını istediğiniz varlık türlerini belirtin. Yalnızca belirttiğiniz türler döndürülür. Nokta belirttiğiniz varlık türleriyle eşlenemiyorsa, yanıtta konum bilgisi döndürülemez. Varsayılan değer tüm olası varlıklardır. Aşağıdaki seçeneklerden seçilen varlık türlerinin virgülle ayrılmış listesi. Adres Mahalle PopulatedPlace Postcode1 AdminDivision1 AdminDivision2 CountryRegion Bu varlık türleri en belirli varlıktan en az belirli varlığa sıralanır. Birden fazla varlık türündeki varlıklar bulunduğunda, yalnızca en belirli varlık döndürülür. Örneğin, varlık türleri olarak Address ve AdminDistrict1 belirtirseniz ve her iki tür için de varlıklar bulunduysa, yanıtta yalnızca Adres varlık bilgileri döndürülür.
ReverseGeocodingBatchRequestBody	İşlenmek üzere ters coğrafi kodlama sorguları/istekleri listesi. Liste en fazla 100 sorgu içerebilir ve en az 1 sorgu içermelidir.
ReverseGeocodingBatchRequestItem	Batch Sorgusu nesnesi
Summary	Toplu iş isteğinin özeti
UsageTypeEnum	Coğrafi kod noktası için en iyi kullanım. Her coğrafi kod noktası nokta `Route` , `Display` nokta veya her ikisi olarak tanımlanır. Konuma bir yol oluşturuyorsanız noktaları kullanın `Route` . Konumu haritada gösteriyorsanız noktaları kullanın `Display` . Örneğin, konum bir parksa, bir `Route` nokta parka bir araba ile girebileceğiniz bir giriş belirtebilir ve bir `Display` nokta da parkın merkezini belirten bir nokta olabilir.

Address

Sonucun adresi

Name	Tür	Description
addressLine	string	Sokak Adı ve Numarası içeren AddressLine
adminDistricts	AdminDistricts[]	Bir adresin ülke veya bölgedeki alt bölüm adı. Bu öğe genellikle birinci sıra yönetim alt bölümü olarak değerlendirilir, ancak bazı durumlarda bir ülke, bağımlılık veya bölgedeki ikinci, üçüncü veya dördüncü sıra alt bölümünü de içerir.
countryRegion	CountryRegion
formattedAddress	string	Biçimlendirilmiş Adres özelliği
intersection	Intersection	Sonucun adresi.
locality	string	locality özelliği
neighborhood	string	mahalle özelliği
postalCode	string	Posta Kodu özelliği

AdminDistricts

Bir adresin ülke veya bölgedeki alt bölüm adı. Bu öğe genellikle birinci sıra yönetim alt bölümü olarak değerlendirilir, ancak bazı durumlarda bir ülke, bağımlılık veya bölgedeki ikinci, üçüncü veya dördüncü sıra alt bölümünü de içerir.

Name	Tür	Description
name	string	karşılık gelen adminDistrict alanının adı olan adminDistrict[0] için bu, Washington, For adminDistrict[1] gibi bir eyaletin tam adı olabilir; bu, ilçenin tam adı olabilir
shortName	string	karşılık gelen adminDistrict alanının kısa adı olan AdminDistrict[0] için bu, WA, For adminDistrict[1] gibi kısa bir durum adı olabilir; bu, ilçenin kısa adı olabilir

CalculationMethodEnum

Coğrafi kod noktasını hesaplamak için kullanılan yöntem.

Name	Tür	Description
Interpolation	string	Coğrafi kod noktası, ilişkilendirme kullanılarak yol üzerindeki bir noktayla eşleştirildi.
InterpolationOffset	string	Coğrafi kod noktası, noktayı caddenin kenarına kaydırmak için ek bir uzaklık ile ilişkilendirme kullanılarak yol üzerindeki bir noktayla eşleştirildi.
Parcel	string	Coğrafi kod noktası bir parselin merkeziyle eşleştirildi.
Rooftop	string	Coğrafi kod noktası bir binanın çatısı ile eşleşti.

ConfidenceEnum

Coğrafi olarak kodlanmış konum sonucunun eşleşmesi güven düzeyi. Eşleşme hakkında daha fazla bilgi için bu değeri eşleştirme koduyla birlikte kullanın.

Coğrafi olarak kodlanmış bir konumun güvenilirliği, coğrafi olarak kodlanmış konumun ve belirtildiyse kullanıcının konumunun göreli önemi de dahil olmak üzere birçok faktöre dayanır.

Name Tür Description

High

Name	Tür	Description
High	string	Güven olarak ayarlandıysa `High`, bir veya daha fazla güçlü eşleşme bulundu. Birden çok `High` güvenilirlik eşleşmesi, uygun olduğunda önem derecelerine göre sıralanır. Örneğin, yer işaretlerinin önemi vardır ancak adresler önemli değildir. bir istek bir konum veya görünüm içeriyorsa, sıralama uygun şekilde değişebilir. Örneğin, "Paris" için konum sorgusu "Paris, Fransa" ve "Paris, TX" ifadelerini `High` güvenle döndürür. "Paris, Fransa", bir kullanıcı konumu kullanıcının Paris, TX veya harita görünümü içinde veya çok yakın olduğunu belirtmediği sürece önem derecesi nedeniyle her zaman birinci sırada yer alır.
Low	string
Medium	string	Bazı durumlarda, döndürülen eşleşme istekte sağlanan bilgilerle aynı düzeyde olmayabilir. Örneğin, bir istek adres bilgilerini belirtebilir ve coğrafi kod hizmeti yalnızca bir posta koduyla eşleşebilir. Bu durumda, coğrafi kod hizmeti posta kodunun verilerle eşleştiğinden eminse, güvenilirlik olarak ayarlanır `Medium` ve eşleştirme kodu tüm bilgilerle eşleşmediğini ve hiyerarşide arama yapmak zorunda kaldığını belirtmek için olarak ayarlanır `UpHierarchy` . Sorgudaki konum bilgileri belirsizse ve konumları sıralamak için ek bilgi yoksa (örneğin, kullanıcı konumu veya konumun göreli önemi), güvenilirlik olarak `Medium`ayarlanır. Örneğin, "148th Ave, Bellevue" için bir konum sorgusu "148th Ave SE" ve "148th Ave NE" `Medium` ifadelerini güvenle döndürebilir. Sorgudaki konum bilgileri belirli bir konumu coğrafi kodlamak için yeterli bilgi sağlamıyorsa, daha az kesin bir konum değeri döndürülebilir ve güvenilirlik olarak `Medium`ayarlanır. Örneğin, bir adres sağlanmışsa ancak ev numarası için eşleşme bulunamazsa, Roadblock varlık türüne sahip coğrafi kod sonucu döndürülebilir.

string

Güven olarak ayarlandıysa High, bir veya daha fazla güçlü eşleşme bulundu. Birden çok High güvenilirlik eşleşmesi, uygun olduğunda önem derecelerine göre sıralanır. Örneğin, yer işaretlerinin önemi vardır ancak adresler önemli değildir.

bir istek bir konum veya görünüm içeriyorsa, sıralama uygun şekilde değişebilir. Örneğin, "Paris" için konum sorgusu "Paris, Fransa" ve "Paris, TX" ifadelerini High güvenle döndürür. "Paris, Fransa", bir kullanıcı konumu kullanıcının Paris, TX veya harita görünümü içinde veya çok yakın olduğunu belirtmediği sürece önem derecesi nedeniyle her zaman birinci sırada yer alır.

Low

string

Medium

string

Bazı durumlarda, döndürülen eşleşme istekte sağlanan bilgilerle aynı düzeyde olmayabilir. Örneğin, bir istek adres bilgilerini belirtebilir ve coğrafi kod hizmeti yalnızca bir posta koduyla eşleşebilir. Bu durumda, coğrafi kod hizmeti posta kodunun verilerle eşleştiğinden eminse, güvenilirlik olarak ayarlanır Medium ve eşleştirme kodu tüm bilgilerle eşleşmediğini ve hiyerarşide arama yapmak zorunda kaldığını belirtmek için olarak ayarlanır UpHierarchy .

Sorgudaki konum bilgileri belirsizse ve konumları sıralamak için ek bilgi yoksa (örneğin, kullanıcı konumu veya konumun göreli önemi), güvenilirlik olarak Mediumayarlanır. Örneğin, "148th Ave, Bellevue" için bir konum sorgusu "148th Ave SE" ve "148th Ave NE" Medium ifadelerini güvenle döndürebilir.

Sorgudaki konum bilgileri belirli bir konumu coğrafi kodlamak için yeterli bilgi sağlamıyorsa, daha az kesin bir konum değeri döndürülebilir ve güvenilirlik olarak Mediumayarlanır. Örneğin, bir adres sağlanmışsa ancak ev numarası için eşleşme bulunamazsa, Roadblock varlık türüne sahip coğrafi kod sonucu döndürülebilir.

CountryRegion

Name	Tür	Description
ISO	string	Ülke/bölge ISO'sunun
name	string	ülke/bölge adı

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

FeatureCollectionEnum

FeatureCollection nesnesinin türü FeatureCollection olmalıdır.

Name	Tür	Description
FeatureCollection	string

FeaturesItem

Name	Tür	Description
bbox	number[]	Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın.
geometry	GeoJsonPoint	Geçerli `GeoJSON Point` bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
id	string	Döndürülen özelliğin kimliği
properties	Properties
type	FeatureTypeEnum	Bir özelliğin türü Özellik olmalıdır.

FeatureTypeEnum

Bir özelliğin türü Özellik olmalıdır.

Name	Tür	Description
Feature	string

GeocodePoints

Hesaplanma şekline ve önerilen kullanımlarına göre farklılık gösteren bir coğrafi kod noktaları koleksiyonu.

Name	Tür	Description
calculationMethod	CalculationMethodEnum	Coğrafi kod noktasını hesaplamak için kullanılan yöntem.
geometry	GeoJsonPoint	Geçerli `GeoJSON Point` bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
usageTypes	UsageTypeEnum[]	Coğrafi kod noktası için en iyi kullanım. Her coğrafi kod noktası nokta `Route` , `Display` nokta veya her ikisi olarak tanımlanır. Konuma bir yol oluşturuyorsanız noktaları kullanın `Route` . Konumu haritada gösteriyorsanız noktaları kullanın `Display` . Örneğin, konum bir parksa, bir `Route` nokta parka bir araba ile girebileceğiniz bir giriş belirtebilir ve bir `Display` nokta da parkın merkezini belirten bir nokta olabilir.

GeocodingBatchResponse

Bu nesne başarılı bir Coğrafi Kodlama Batch hizmeti çağrısından döndürülür.

Name	Tür	Description
batchItems	GeocodingBatchResponseItem[]	Toplu iş sonuçlarını içeren dizi.
nextLink	string	, döndürülen özelliklerin sonraki sayfasının bağlantısıdır. Bu son sayfaysa, bu alan yok.
summary	Summary	Toplu iş isteğinin özeti

GeocodingBatchResponseItem

Name	Tür	Description
error	ErrorDetail	Hata ayrıntısı.
features	FeaturesItem[]
nextLink	string	, döndürülen özelliklerin sonraki sayfasının bağlantısıdır. Bu son sayfaysa, bu alan yok.
optionalId	string	istekteki kimlikle aynı olacak batchItem kimliği
type	FeatureCollectionEnum	FeatureCollection nesnesinin türü FeatureCollection olmalıdır.

GeoJsonPoint

Geçerli GeoJSON Point bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.

Name	Tür	Description
bbox	number[]	Sınırlayıcı kutu. Kullanılan projeksiyon - EPSG:3857. Ayrıntılar için lütfen RFC 7946'ya bakın.
coordinates	number[]	A `Position` , iki veya daha fazla öğe içeren bir sayı dizisidir. İlk iki öğe boylam ve enlemdir ve tam olarak bu sıradadır. Rakım/Yükseklik isteğe bağlı bir üçüncü öğedir. Ayrıntılar için lütfen RFC 7946'ya bakın.
type	string: Point	`GeoJSON` Türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.

Intersection

Sonucun adresi.

Name	Tür	Description
baseStreet	string	Yer için birincil cadde.
displayName	string	Kesişimin tam adı.
intersectionType	string	Kesişim türü.
secondaryStreet1	string	kesişen ilk sokak.
secondaryStreet2	string	Varsa, kesişen ikinci sokak.

MatchCodesEnum

Yanıttaki her konum için coğrafi kodlama düzeyini temsil eden bir veya daha fazla kod değeri eşleştirin.

Örneğin, eşleme kodları Good içeren coğrafi olarak kodlanmış bir konum ve Ambiguous konum bilgileri için birden fazla coğrafi kod konumu bulunduğu ve coğrafi kod hizmetinin eşleşme bulmak için hiyerarşide arama yapmadığı anlamına gelir.

Benzer şekilde, eşleme kodları Ambiguous ve UpHierarchy ile coğrafi olarak kodlanmış bir konum, sağlanan tüm konum bilgileriyle eşleşen bir coğrafi kod konumunun bulunamadığını gösterir, bu nedenle coğrafi kod hizmetinin hiyerarşiyi yukarı araması gerekiyordu ve bu düzeyde birden çok eşleşme buldu. Ve sonucunun AmbiguousUpHierarchy bir örneği, tam adres bilgilerini sağladığınız, ancak coğrafi kod hizmetinin sokak adresi için bir eşleşme bulamadığı ve bunun yerine birden fazla RoadBlock değeri için bilgi döndürdüğü durumdur.

Olası değerler şunlardır:

Good: Konumda yalnızca bir eşleşme vardır veya döndürülen tüm eşleşmeler güçlü eşleşmeler olarak kabul edilir. Örneğin, New York sorgusu birkaç İyi eşleşme döndürür.

Ambiguous: Konum, olası eşleşme kümelerinden biridir. Örneğin, 128 Ana Cadde sokak adresini sorguladığınızda, hangi seçeneğin seçileceğini belirlemek için yeterli bilgi olmadığından, yanıt 128 Kuzey Ana Cadde ve 128 Güney Ana Cadde için iki konum döndürebilir.

UpHierarchy: Konum, coğrafi hiyerarşide yukarı taşımayı temsil eder. Konum isteği için eşleşme bulunamadığında bu durum oluşur, bu nedenle daha az kesin bir sonuç döndürülür. Örneğin, istenen adres için bir eşleşme bulunamazsa, RoadBlock varlık türüyle eşleşme kodu UpHierarchy döndürülebilir.

Name	Tür	Description
Ambiguous	string
Good	string
UpHierarchy	string

Properties

Name	Tür	Description
address	Address	Sonucun adresi
confidence	ConfidenceEnum	Coğrafi olarak kodlanmış konum sonucunun eşleşmesi güven düzeyi. Eşleşme hakkında daha fazla bilgi için bu değeri eşleştirme koduyla birlikte kullanın. Coğrafi olarak kodlanmış bir konumun güvenilirliği, coğrafi olarak kodlanmış konumun ve belirtildiyse kullanıcının konumunun göreli önemi de dahil olmak üzere birçok faktöre dayanır.
geocodePoints	GeocodePoints[]	Hesaplanma şekline ve önerilen kullanımlarına göre farklılık gösteren bir coğrafi kod noktaları koleksiyonu.
matchCodes	MatchCodesEnum[]	Yanıttaki her konum için coğrafi kodlama düzeyini temsil eden bir veya daha fazla kod değeri eşleştirin. Örneğin, eşleme kodları `Good` içeren coğrafi olarak kodlanmış bir konum ve `Ambiguous` konum bilgileri için birden fazla coğrafi kod konumu bulunduğu ve coğrafi kod hizmetinin eşleşme bulmak için hiyerarşide arama yapmadığı anlamına gelir. Benzer şekilde, eşleme kodları `Ambiguous` ve `UpHierarchy` ile coğrafi olarak kodlanmış bir konum, sağlanan tüm konum bilgileriyle eşleşen bir coğrafi kod konumunun bulunamadığını gösterir, bu nedenle coğrafi kod hizmetinin hiyerarşiyi yukarı araması gerekiyordu ve bu düzeyde birden çok eşleşme buldu. Ve sonucunun `AmbiguousUpHierarchy` bir örneği, tam adres bilgilerini sağladığınız, ancak coğrafi kod hizmetinin sokak adresi için bir eşleşme bulamadığı ve bunun yerine birden fazla RoadBlock değeri için bilgi döndürdüğü durumdur. Olası değerler şunlardır: `Good`: Konumda yalnızca bir eşleşme vardır veya döndürülen tüm eşleşmeler güçlü eşleşmeler olarak kabul edilir. Örneğin, New York sorgusu birkaç İyi eşleşme döndürür. `Ambiguous`: Konum, olası eşleşme kümelerinden biridir. Örneğin, 128 Ana Cadde sokak adresini sorguladığınızda, hangi seçeneğin seçileceğini belirlemek için yeterli bilgi olmadığından, yanıt 128 Kuzey Ana Cadde ve 128 Güney Ana Cadde için iki konum döndürebilir. `UpHierarchy`: Konum, coğrafi hiyerarşide yukarı taşımayı temsil eder. Konum isteği için eşleşme bulunamadığında bu durum oluşur, bu nedenle daha az kesin bir sonuç döndürülür. Örneğin, istenen adres için bir eşleşme bulunamazsa, RoadBlock varlık türüyle eşleşme kodu `UpHierarchy` döndürülebilir.
type	string	Bunlardan biri: Adres Barikat RoadIntersection Mahalle PopulatedPlace Postcode1 AdminDivision1 AdminDivision2 CountryRegion

ResultTypeEnum

Yanıtta olmasını istediğiniz varlık türlerini belirtin. Yalnızca belirttiğiniz türler döndürülür. Nokta belirttiğiniz varlık türleriyle eşlenemiyorsa, yanıtta konum bilgisi döndürülemez. Varsayılan değer tüm olası varlıklardır. Aşağıdaki seçeneklerden seçilen varlık türlerinin virgülle ayrılmış listesi.

Adres
Mahalle
PopulatedPlace
Postcode1
AdminDivision1
AdminDivision2
CountryRegion

Bu varlık türleri en belirli varlıktan en az belirli varlığa sıralanır. Birden fazla varlık türündeki varlıklar bulunduğunda, yalnızca en belirli varlık döndürülür. Örneğin, varlık türleri olarak Address ve AdminDistrict1 belirtirseniz ve her iki tür için de varlıklar bulunduysa, yanıtta yalnızca Adres varlık bilgileri döndürülür.

Name	Tür	Description
Address	string
AdminDivision1	string
AdminDivision2	string
CountryRegion	string
Neighborhood	string
PopulatedPlace	string
Postcode1	string

ReverseGeocodingBatchRequestBody

İşlenmek üzere ters coğrafi kodlama sorguları/istekleri listesi. Liste en fazla 100 sorgu içerebilir ve en az 1 sorgu içermelidir.

Name	Tür	Description
batchItems	ReverseGeocodingBatchRequestItem[]	İşlenmek üzere sorguların listesi.

ReverseGeocodingBatchRequestItem

Batch Sorgusu nesnesi

Name	Tür	Description
coordinates	number[]	Coğrafi kodlamayı ters çevirmek istediğiniz konumun koordinatları. Örnek: [lon,lat]
optionalId	string	karşılık gelen batchItem içinde gösterilecek isteğin kimliği
resultTypes	ResultTypeEnum[]	Yanıtta olmasını istediğiniz varlık türlerini belirtin. Yalnızca belirttiğiniz türler döndürülür. Nokta belirttiğiniz varlık türleriyle eşlenemiyorsa, yanıtta konum bilgisi döndürülemez. Varsayılan değer tüm olası varlıklardır. Aşağıdaki seçeneklerden seçilen varlık türlerinin virgülle ayrılmış listesi. Adres Mahalle PopulatedPlace Postcode1 AdminDivision1 AdminDivision2 CountryRegion Bu varlık türleri en belirli varlıktan en az belirli varlığa sıralanır. Birden fazla varlık türündeki varlıklar bulunduğunda, yalnızca en belirli varlık döndürülür. Örneğin, varlık türleri olarak Address ve AdminDistrict1 belirtirseniz ve her iki tür için de varlıklar bulunduysa, yanıtta yalnızca Adres varlık bilgileri döndürülür.
view	string	ISO 3166-1 Alfa-2 bölge/ülke kodunu belirten bir dize. Bu, jeopolitik ihtilaflı kenarlıkları ve etiketleri belirtilen kullanıcı bölgesiyle uyumlu olacak şekilde değiştirir.

Summary

Toplu iş isteğinin özeti

Name	Tür	Description
successfulRequests	integer	Toplu işlemdeki başarılı istek sayısı
totalRequests	integer	Toplu iş içindeki toplam istek sayısı

UsageTypeEnum

Coğrafi kod noktası için en iyi kullanım. Her coğrafi kod noktası nokta Route , Display nokta veya her ikisi olarak tanımlanır. Konuma bir yol oluşturuyorsanız noktaları kullanın Route . Konumu haritada gösteriyorsanız noktaları kullanın Display . Örneğin, konum bir parksa, bir Route nokta parka bir araba ile girebileceğiniz bir giriş belirtebilir ve bir Display nokta da parkın merkezini belirten bir nokta olabilir.

Name	Tür	Description
Display	string
Route	string

Search - Get Reverse Geocoding Batch

Zaman Uyumlu Toplu İş İsteği Gönder

Toplu İstek için POST Gövdesi

Toplu Yanıt Modeli

URI Parametreleri

İstek Başlığı

İstek Gövdesi

Yanıtlar

Güvenlik

AADToken

Scopes

subscription-key

SAS Token

Örnekler

A Reverse Geocoding Batch API call containing 2 Reverse Geocoding queries

Sample Request

Sample Response

Tanımlar

Address

AdminDistricts

CalculationMethodEnum

ConfidenceEnum

CountryRegion

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FeatureCollectionEnum

FeaturesItem

FeatureTypeEnum

GeocodePoints

GeocodingBatchResponse

GeocodingBatchResponseItem

GeoJsonPoint

Intersection

MatchCodesEnum

Properties

ResultTypeEnum

ReverseGeocodingBatchRequestBody

ReverseGeocodingBatchRequestItem

Summary

UsageTypeEnum

Ek kaynaklar