Search

  • Başvuru
Service:
Maps
API Version:
1.0

Operations

Get Search Address

Adres coğrafi kodlama

Uygulama hedefi: S0 ve S1 fiyatlandırma katmanları.

Çoğu durumda, yalnızca geleneksel coğrafi kodlama ile ilgileniyorsanız, örneğin, tüm arama hizmeti çok fazla olabilir. Ayrıca, adrese özel olarak bakmak için aramaya de erişilebilir. Coğrafi kodlama, coğrafi kod uç noktasına yalnızca ilgili adres veya kısmi adresle vurarak yapılır. Geokodlamaya ilişkin arama dizini, cadde düzeyindeki verilerin üzerindeki her şey için sorgulanacaktır. Hiçbir POI döndürülmeyecektir. Geocoder 'ın, yazım hatalarını ve tamamlanmamış adreslerin çok dayanıklı olduğunu unutmayın. Ayrıca, tam sokak adreslerinden veya sokak ya da kesişimlerden yanı sıra şehir merkezleri, ilçeler, eyalet vb. gibi daha üst düzey coğrafi öğeler de ele alınacaktır.
Get Search Address Reverse

Coğrafi kodu bir adrese çevirin

Uygulama hedefi: S0 ve S1 fiyatlandırma katmanları.

Bir koordinatı (örnek: 37,786505,-122,3862) insan tarafından erişilebilir bir açık adrese çevirmeniz gerektiği zamanlar olabilir. Genellikle bu, cihazdan veya varlıktan bir GPS akışı aldığınız ve koordinatın bulunduğu adresi belirlemek istediğiniz uygulamaları izlemek için gereklidir. Bu uç nokta, belirli bir koordinat için adres bilgilerini döndürür.
Get Search Address Reverse Cross Street

Geocode 'u çapraz cadde tersine çevir

Uygulama hedefi: S0 ve S1 fiyatlandırma katmanları.

Bir koordinatı (örnek: 37,786505,-122,3862), insan dışı bir çapraz cadde halinde çevirmeniz gerektiğinde zaman alabilir. Genellikle bu, cihazdan veya varlıktan bir GPS akışı aldığınız ve koordinatın bulunduğu adresi belirlemek istediğiniz uygulamaları izlemek için gereklidir. Bu uç nokta, belirli bir koordinat için çapraz sokak bilgileri döndürür.
Get Search Address Structured

Yapılandırılmış adres coğrafi kodlama

Uygulama hedefi: S0 ve S1 fiyatlandırma katmanları.

Yapılandırılmış adres için özel olarak Azure adresi coğrafi kodlamaya de erişilebilir. Geokodlamaya ilişkin arama dizini, cadde düzeyindeki verilerin üzerindeki her şey için sorgulanacaktır. Hiçbir POI döndürülmeyecektir. Geocoder 'ın, yazım hatalarını ve tamamlanmamış adreslerin çok dayanıklı olduğunu unutmayın. Ayrıca, tam sokak adreslerinden veya sokak ya da kesişimlerden yanı sıra şehir merkezleri, ilçeler, eyalet vb. gibi daha üst düzey coğrafi öğeler de ele alınacaktır.
Get Search Fuzzy

Ücretsiz form arama

Uygulama hedefi: S0 ve S1 fiyatlandırma katmanları.

Temel varsayılan API, herhangi bir adres veya POı belirtecinin birleşimini işleyen girişlerin en belirsiz şekilde işlediği ücretsiz form aramadır. Bu arama API 'SI, kurallı ' tek satırlı arama ' ' dır. Ücretsiz form arama API 'SI, POı araması ve coğrafi kodlama için sorunsuz bir birleşimidir. API ayrıca bağlamsal bir konum (Lat./Lonla de ağırlıklı olabilir. eşleştirin) veya bir koordinat ve yarıçap tarafından tam olarak kısıtlanıyor ya da herhangi bir coğrafi düzenleme noktası noktası olmadan daha genel olarak Yürütülebilirler.

Yalnızca uygulamanızın kapsama ihtiyacı olan ülkeleri belirtmek için ' countrySet ' parametresini kullanmanızı önemle tavsiye ederiz. varsayılan davranış, dünyanın tamamında arama yapmak ve potansiyel olarak gereksiz sonuçlar döndürmektir.

Ör.: countrySet = US, fr

Lütfen tüm desteklenen ülkelerin listesini görmek için bkz. arama kapsamı .

Çoğu arama maxFuzzyLevel , performansı elde etmek ve ayrıca olağandışı sonuçları azaltmak için varsayılan olarak = 2 ' dir. Bu yeni varsayılan değer, sorgu param maxFuzzyLevel = 3 veya 4 ' te geçerek istek başına gerektiği şekilde geçersiz kılınabilir.
Get Search Nearby

Yakındaki arama

Uygulama hedefi: S0 ve S1 fiyatlandırma katmanları.

Yalnızca belirli bir konum etrafında POı sonuçlarının alınması için bir kullanım örneğine sahipseniz, yakındaki arama yöntemi doğru seçim olabilir. Bu uç nokta yalnızca POI sonuçlarını döndürür ve bir arama sorgu parametresi almaz.
Get Search POI

Ada göre POı al

Uygulama hedefi: S0 ve S1 fiyatlandırma katmanları.

Ilgi noktaları (POı) arama, ad olarak bir POı sonuçları isteyebilmeniz için izin verir. Arama, dil gibi ek sorgu parametrelerini destekler ve ülkeye veya sınırlayıcı kutuya göre çalışan ilgi alanına göre sonuçları filtreler. Uç nokta yalnızca sorgu dizesiyle eşleşen bir POı sonuçları döndürüyor. Yanıt, adres, koordinat konumu ve kategori gibi POı ayrıntılarını içerir.
Get Search POI Category

Kategoriye göre POı al

Uygulama hedefi: S0 ve S1 fiyatlandırma katmanları.

Ilgi noktaları (POı) Kategori arama, verilen kategoriden POı sonuçları talep etmenizi sağlar. Arama, tek seferde bir kategoriden POI sorgulamak için izin verir. Uç nokta yalnızca belirtilen şekilde kategorilere ayrılmamış bir POı sonuçları döndürür. Yanıt, adres, koordinat konumu ve sınıflandırma gibi POı ayrıntılarını içerir.
Get Search POI Category Tree Preview

POı kategorisi ağacını al

Uygulama hedefi: S0 ve S1 fiyatlandırma katmanları.

POı kategorisi API 'SI, desteklenen Ilgi noktaları (POı) kategorilerinin ve alt kategorilerinin, çevirileri ve eşanlamlılarıyla birlikte tam bir listesini sağlar. Döndürülen içerik, arama POI algibi diğer arama hizmeti API 'leri aracılığıyla daha anlamlı sonuçlar sağlamak için kullanılabilir.
Get Search Polygon

Çokgen al

Uygulama hedefi: S1 fiyatlandırma katmanı.

Çokgen al hizmeti, daha önce GeoJSON biçiminde bir çevrimiçi arama isteğinden alınan bir varlık kümesi için şehir veya ülke ana hattı gibi geometri verilerini talep etmenize olanak tanır. Geometri KIMLIĞI, bir arama adresi içinde "Geometry" ve "ID" altındaki dataSources nesnesinde döndürülür veya benzer bir çağrıda arama yapın.

Çevrimiçi arama uç noktasından alınan tüm geometri KIMLIKLERI sınırlı bir yaşam süresine sahip olduğunu lütfen unutmayın. Bu tanımlayıcıların kararlılığı uzun bir süre boyunca garanti edilmediği için, istemci, daha sonra başvuru için, geometri kimliklerini kalıcı depolamada depomamalıdır. Çokgen yöntemine yönelik bir isteğin, KIMLIĞI sağlayan çevrimiçi arama yöntemine yapılan istek için birkaç dakika içinde yapılması beklenmektedir. Hizmet, toplu isteklere 20 tanımlayıcıya kadar izin verir.
Post Search Address Batch

Arama adresi Batch API 'SI

Uygulama hedefi: S1 fiyatlandırma katmanı.

Arama adresi Batch API 'SI yalnızca tek bir API çağrısını kullanarak Adres API 'Si aramak için sorgu toplu işlemleri gönderir. Zaman uyumsuz (Async) ya da zaman uyumlu (eşitleme) çalıştırmak için arama adresi Batch API 'sini çağırabilirsiniz. Zaman uyumsuz API, çağıranın 10.000 'e kadar sorgu ve eşitleme API 'sine kadar 100 sorguya kadar toplu iş yapmasına izin verir.

Zaman uyumlu toplu Istek gönder

Zaman uyumlu API, hafif Toplu istekler için önerilir. Hizmet bir istek aldığında, Batch öğeleri hesaplandığında yanıt verir ve sonuçları daha sonra almak mümkün olmayacaktır. İstek 60 saniyeden uzun sürerse zaman uyumlu API bir zaman aşımı hatası (408 yanıt) döndürür. Batch öğelerinin sayısı bu API için 100 ile sınırlıdır.

POST https://atlas.microsoft.com/search/address/batch/sync/json?api-version=1.0&subscription-key={subscription-key}

Zaman uyumsuz toplu Istek gönder

Zaman uyumsuz API, oldukça karmaşık arama isteklerinin büyük hacimlerini işlemek için uygundur

  • Sonuçların ayrı bir çağrıda alınmasına izin verir (birden fazla indirme mümkündür).
  • Zaman uyumsuz API, güvenilirlik açısından iyileştirilmiştir ve bir zaman aşımı olarak çalıştırılması beklenmez.
  • Batch öğelerinin sayısı bu API için 10.000 ile sınırlıdır.

Zaman uyumsuz istek kullanarak bir istek yaptığınızda, hizmet varsayılan olarak Yanıt üstbilgisinin konum alanındaki bir yeniden yönlendirme URL 'SI üzerinde 202 yanıt kodu döndürür. Bu URL, yanıt verileri veya hata bilgileri kullanılabilir olana kadar düzenli aralıklarla denetlenmelidir. Zaman uyumsuz yanıtlar 14 gün boyunca depolanır. Yeniden yönlendirme URL 'SI, süre sonu süresinden sonra kullanılıyorsa 404 yanıtını döndürür.

Zaman uyumsuz toplu iş isteğinin uzun süre çalışan bir istek olduğunu lütfen unutmayın. Tipik bir işlem dizisi aşağıda verilmiştir:

  1. istemci Azure Haritalar bir arama adresi toplu POST isteği gönderir

  2. Sunucu, aşağıdakilerden biriyle yanıt verir:

    HTTP 202 Accepted -Batch isteği kabul edildi.

    HTTP Error -Batch isteğiniz işlenirken bir hata oluştu. Bu ya da başka bir 400 Bad Request Error durum kodu olabilir.

  3. Toplu iş isteği başarıyla kabul edildiyse, Location yanıttaki üstbilgi toplu istek sonuçlarının indirileceği URL 'yi içerir. Bu durum URI 'SI aşağıdaki gibi görünür:

    GET https://atlas.microsoft.com/search/address/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}
  1. İstemci GET , toplu sonuçları indirmek Için adım 3 ' te elde edilen indirme URL 'sinde bir istek yayınlar.

Toplu Istek için gövde gönder

Arama adresi sorgularını göndermek için, POST istek gövdesinin diziyi biçimde içereceği bir istek kullanacaksınız batchItems json ve Content-Type üst bilgi olarak ayarlanır application/json . 5 arama adresi sorgusu içeren örnek bir istek gövdesi aşağıda verilmiştir:

{
    "batchItems": [
        {"query": "?query=400 Broad St, Seattle, WA 98109&limit=3"},
        {"query": "?query=One, Microsoft Way, Redmond, WA 98052&limit=3"},
        {"query": "?query=350 5th Ave, New York, NY 10118&limit=1"},
        {"query": "?query=Pike Pl, Seattle, WA 98101&lat=47.610970&lon=-122.342469&radius=1000"},
        {"query": "?query=Champ de Mars, 5 Avenue Anatole France, 75007 Paris, France&limit=1"}
    ]
}

Toplu işteki arama adresi sorgusu protokol, temel URL, yol, api sürümü ve abonelik anahtarı olmadan yalnızca kısmi bir URL'dir. Desteklenen arama adresi URI parametrelerinin herhangi birini kabul eder. Arama adresi sorgusunda dize değerlerinin düzgün bir şekilde kaçarak (örneğin " karakteriyle kaçarak) olması ve ayrıca URL ile \ kodlanmış olması gerekir.

Zaman uyumsuz API, çağıranın en fazla 10.000 sorguyu toplu işlemesini ve en fazla 100 sorguyu eşitleme API'sini kullanmasını sağlar ve toplu iş en az 1 sorgu içerebilir.

Zaman Uyumsuz Toplu İş Sonuçlarını İndirme

Zaman uyumsuz toplu iş sonuçlarını indirmek için toplu iş indirme GET uç noktasına bir istek gönderilir. Bu indirme URL'si, başarılı bir toplu iş Location isteğinin üst POST bilgilerinden elde edilebilir ve aşağıdaki gibi görünür:

https://atlas.microsoft.com/search/address/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}

Toplu iş sonuçlarını indirmeye yönelik tipik işlem sırası şu şekildedir:

  1. İstemci, indirme GET URL'sini kullanarak bir istek gönderir.

  2. Sunucu, aşağıdakilerden biri ile yanıt verir:

    HTTP 202 Accepted - Batch isteği kabul edildi ama hala işleniyor. Lütfen bir süre sonra yeniden deneyin.

    HTTP 200 OK - Batch isteği başarıyla işlendi. Yanıt gövdesi tüm toplu iş sonuçlarını içerir.

Toplu Yanıt Modeli

Döndürülen veri içeriği, zaman uyumsuz ve eşitleme istekleri için benzerdir. Zaman uyumsuz bir toplu iş isteğinin sonuçlarını indirirken, toplu iş işlemeyi bitirmişse yanıt gövdesi toplu iş yanıtını içerir. Bu toplu iş yanıtı, özgün toplu iş isteğinin parçası olan ve yani başarıyla yürütülen summary sorguları belirten bir bileşen totalRequests successfulRequests içerir. Toplu iş yanıtı, toplu batchItems iş isteğinde her bir sorgu için yanıt içeren bir dizi de içerir. batchItems, sonuçları toplu iş isteğinde gönderilen özgün sorguların tam olarak aynı sırayla içerir. içinde her öğe batchItems ve statusCode alanları response içerir. içinde response batchItems her biri aşağıdaki türlerden biridir:

  • SearchAddressResponse - Sorgu başarıyla tamamlandı ise.

  • Error - Sorgu başarısız olursa. Yanıt, bu durumda code bir ve message içerir.

2 başarılı ve 1 başarısız sonuç ile örnek bir Batch Yanıtı:

{
    "summary": {
        "successfulRequests": 2,
        "totalRequests": 3
    },
    "batchItems": [
        {
            "statusCode": 200,
            "response":
            {
                "summary": {
                    "query": "one microsoft way redmond wa 98052"
                },
                "results": [
                    {
                        "position": {
                            "lat": 47.63989,
                            "lon": -122.12509
                        }
                    }
                ]
            }
        },
        {
            "statusCode": 200,
            "response":
            {
                "summary": {
                    "query": "pike pl seattle wa 98101"
                },
                "results": [
                    {
                        "position": {
                            "lat": 47.60963,
                            "lon": -122.34215
                        }
                    }
                ]
            }
        },
        {
            "statusCode": 400,
            "response":
            {
                "error":
                {
                    "code": "400 BadRequest",
                    "message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
                }
            }
        }
    ]
}
Post Search Address Reverse Batch

Arama Adresi Ters Batch API'si

Için geçerlidir: S1 fiyatlandırma katmanı.

Arama Adresi Toplu İş API'si yalnızca tek bir API çağrısı kullanarak Arama Adresi Ters API'sinde toplu sorgular gönderir. Zaman uyumsuz (zaman uyumsuz) veya zaman uyumlu (eşitleme) çalıştırmak için Arama Adresi Ters Toplu İş API'sini çağırabilirsiniz. Zaman uyumsuz API, çağıranın en fazla 10.000 sorgu toplu işlemesini ve 100'e kadar sorgu eşitleme API'sini kullanmasını sağlar.

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

Basit toplu iş istekleri 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 olasılığı yoktur. İ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/search/address/reverse/batch/sync/json?api-version=1.0&subscription-key={subscription-key}

Zaman Uyumsuz Toplu İş İsteği Gönderme

Zaman Uyumsuz API, görece karmaşık arama isteklerinin büyük hacimlerini işlemeye uygundur

  • Sonuçların ayrı bir çağrıyla alınmasına olanak sağlar (birden çok indirme mümkündür).
  • Zaman uyumsuz API güvenilirlik için iyileştirilmiştir ve bir zaman aşımına neden olması beklenmiyor.
  • Bu API için toplu iş öğelerinin sayısı 10.000 ile sınırlıdır.

Zaman uyumsuz istek kullanarak istekte bulundursanız, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si üzerinde bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenir. Zaman uyumsuz yanıtlar 14 gün boyunca depolanır. Yeniden yönlendirme URL'si, süre sonu süresi sonra kullanılırsa 404 yanıtı döndürür.

Zaman uyumsuz toplu iş isteğinin uzun süre çalışan bir istek olduğunu lütfen unutmayın. Tipik bir işlem dizisi şöyledir:

  1. İstemci, Azure depolamaya bir POST Arama Adresi Batch isteği Haritalar

  2. Sunucu, aşağıdakilerden biri ile yanıt verir:

    HTTP 202 Accepted - Batch isteği kabul edildi.

    HTTP Error - Batch isteğinizi işlerken bir hata oluştu. Bu bir veya başka 400 Bad Request bir durum Error kodu olabilir.

  3. Toplu iş isteği başarıyla kabul edildiyse, yanıtta üst bilgi toplu iş isteğinin sonuçlarını Location indirmek için URL'yi içerir. Bu durum URI'sı aşağıdaki gibi görünüyor:

    GET https://atlas.microsoft.com/search/address/reverse/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}
  1. İstemci, toplu GET iş sonuçlarını indirmek için 3. Adımda elde edilen indirme URL'sinde bir istek verir.

Batch İsteği için POST Gövdesi

Arama adresi ters sorgularını göndermek için, istek gövdesinin diziyi biçiminde içerdiği ve üst bilgi olarak ayarlanan POST bir istek batchItems json Content-Type application/json kullanırsiniz. 5 arama adresi ters sorgu içeren örnek istek gövdesi şöyledir:

{
    "batchItems": [
        {"query": "?query=48.858561,2.294911"},
        {"query": "?query=47.639765,-122.127896&radius=5000&limit=2"},
        {"query": "?query=47.621028,-122.348170"},
        {"query": "?query=43.722990,10.396695"},
        {"query": "?query=40.750958,-73.982336"}
    ]
}

Toplu işteki arama adresi ters sorgusu protokol, temel URL, yol, api sürümü ve abonelik anahtarı olmayan kısmi bir URL'dir. Desteklenen herhangi bir arama adresi ters URI parametresini kabul eder. Arama adresi ters sorgusunda yer alan dize değerlerinin düzgün bir şekilde kaçarak (örneğin " karakteri ile kaçarak) olması ve aynı zamanda URL ile kodlanmış \ olması gerekir.

Zaman uyumsuz API, çağıranın en fazla 10.000 sorguyu toplu işlemesini ve en fazla 100 sorguyu eşitleme API'sini kullanmasını sağlar ve toplu iş en az 1 sorgu içerebilir.

Zaman Uyumsuz Toplu İş Sonuçlarını İndirme

Zaman uyumsuz toplu iş sonuçlarını indirmek için toplu iş indirme GET uç noktasına bir istek gönderilir. Bu indirme URL'si, başarılı bir toplu iş Location isteğinin üst POST bilgilerinden elde edilebilir ve aşağıdaki gibi görünür:

https://atlas.microsoft.com/search/address/reverse/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}

Toplu iş sonuçlarını indirmeye yönelik tipik işlem sırası şu şekildedir:

  1. İstemci, indirme GET URL'sini kullanarak bir istek gönderir.

  2. Sunucu, aşağıdakilerden biri ile yanıt verir:

    HTTP 202 Accepted - Batch isteği kabul edildi ama hala işleniyor. Lütfen bir süre sonra yeniden deneyin.

    HTTP 200 OK - Batch isteği başarıyla işlendi. Yanıt gövdesi tüm toplu iş sonuçlarını içerir.

Toplu Yanıt Modeli

Döndürülen veri içeriği, zaman uyumsuz ve eşitleme istekleri için benzerdir. Zaman uyumsuz bir toplu iş isteğinin sonuçlarını indirirken, toplu iş işlemeyi bitirmişse yanıt gövdesi toplu iş yanıtını içerir. Bu toplu iş yanıtı, özgün toplu iş isteğinin parçası olan ve yani başarıyla yürütülen summary sorguları belirten bir bileşen totalRequests successfulRequests içerir. Toplu iş yanıtı, toplu batchItems iş isteğinde her bir sorgu için yanıt içeren bir dizi de içerir. batchItems, sonuçları toplu iş isteğinde gönderilen özgün sorguların tam olarak aynı sırayla içerir. içinde her öğe batchItems ve statusCode alanları response içerir. içinde response batchItems her biri aşağıdaki türlerden biridir:

  • SearchAddressReverseResponse - Sorgu başarıyla tamamlandı ise.

  • Error - Sorgu başarısız olursa. Yanıt, bu durumda code bir ve message içerir.

2 başarılı ve 1 başarısız sonuç ile örnek bir Batch Yanıtı:

{
    "summary": {
        "successfulRequests": 2,
        "totalRequests": 3
    },
    "batchItems": [
        {
            "statusCode": 200,
            "response":
            {
                "summary": {
                    "queryTime": 11
                },
                "addresses": [
                    {
                        "address": {
                            "country": "France",
                            "freeformAddress": "Avenue Anatole France, 75007 Paris"
                        },
                        "position": "48.858490,2.294820"
                    }
                ]
            }
        },
        {
            "statusCode": 200,
            "response":
            {
                "summary": {
                    "queryTime": 1
                },
                "addresses": [
                    {
                        "address": {
                            "country": "United States of America",
                            "freeformAddress": "157th Pl NE, Redmond WA 98052"
                        },
                        "position": "47.640470,-122.129430"
                    }
                ]
            }
        },
        {
            "statusCode": 400,
            "response":
            {
                "error":
                {
                    "code": "400 BadRequest",
                    "message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
                }
            }
        }
    ]
}
Post Search Along Route

Için geçerlidir: S0 ve S1 fiyatlandırma katmanları.

Rota boyunca Ara uç noktası, belirtilen yol üzerinde POI'ler için belirsiz arama gerçekleştirmenize olanak sağlar. Bu arama sınırlama ölçüsü belirterek maxDetourTime kısıtlanmış olur.

Yol noktalarını göndermek için istek gövdesinin tür olarak temsil edilen nesneyi içerdiği ve üst bilgisi olarak POST route GeoJSON LineString Content-Type ayarlanır. application/json içinde her yol noktası, boylam değerinin enlem değerinin takip ettiği ve rakım değerinin yoksayılan bir dizi gibi bir route GeoJSON Position tür olarak temsil edilir. en route az 2 yol noktası içermesi gerekir.

Özgün rotanın değiştirilmesi, bazı noktalarının atlanmış olması mümkündür. Bulunan noktadan geçen yol özgün noktadan daha hızlı ise yanıt değeri detourTime negatiftir.
Post Search Fuzzy Batch

Belirsiz Batch API'sini arama

Için geçerlidir: S1 fiyatlandırma katmanı.

Arama Adresi Batch API'si yalnızca tek bir API çağrısı kullanarak Belirsiz Arama API'sinde toplu sorgular gönderir. Zaman uyumsuz (zaman uyumsuz) veya zaman uyumlu (eşitleme) çalıştırmak için Arama Adresi Belirsiz Toplu İş API'sini çağırabilirsiniz. Zaman uyumsuz API, çağıranın en fazla 10.000 sorgu toplu işlemesini ve 100'e kadar sorgu eşitleme API'sini kullanmasını sağlar.

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

Basit toplu iş istekleri 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 olasılığı yoktur. İ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/search/fuzzy/batch/sync/json?api-version=1.0&subscription-key={subscription-key}

Zaman Uyumsuz Toplu İş İsteği Gönderme

Zaman Uyumsuz API, görece karmaşık arama isteklerinin büyük hacimlerini işlemeye uygundur

  • Sonuçların ayrı bir çağrıyla alınmasına olanak sağlar (birden çok indirme mümkündür).
  • Zaman uyumsuz API güvenilirlik için iyileştirilmiştir ve bir zaman aşımına neden olması beklenmiyor.
  • Bu API için toplu iş öğelerinin sayısı 10.000 ile sınırlıdır.

Zaman uyumsuz istek kullanarak istekte bulundursanız, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si üzerinde bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenir. Zaman uyumsuz yanıtlar 14 gün boyunca depolanır. Yeniden yönlendirme URL'si, süre sonu süresi sonra kullanılırsa 404 yanıtı döndürür.

Zaman uyumsuz toplu iş isteğinin uzun süre çalışan bir istek olduğunu lütfen unutmayın. Tipik bir işlem dizisi şöyledir:

  1. İstemci Azure POST Haritalar'a Bir Arama Adresi Toplu İş isteği Haritalar

  2. Sunucu, aşağıdakilerden biri ile yanıt verir:

    HTTP 202 Accepted - Batch isteği kabul edildi.

    HTTP Error - Batch isteğinizi işlerken bir hata oluştu. Bu bir veya başka 400 Bad Request bir durum Error kodu olabilir.

  3. Toplu iş isteği başarıyla kabul edildiyse, yanıtta üst bilgi toplu iş isteğinin sonuçlarını Location indirmek için URL'yi içerir. Bu durum URI'sı aşağıdaki gibi görünüyor:

    GET https://atlas.microsoft.com/search/fuzzy/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}
  1. İstemci, toplu GET iş sonuçlarını indirmek için 3. Adımda elde edilen indirme URL'sinde bir istek verir.

Batch İsteği için POST Gövdesi

Arama belirsiz sorgularını göndermek için istek gövdesinin diziyi biçiminde, üst bilgisi ise olarak ayarlanır. POST batchItems json Content-Type application/json 5 arama belirsiz sorgu içeren örnek istek gövdesi şöyledir:

{
    "batchItems": [
        {"query": "?query=atm&lat=47.639769&lon=-122.128362&radius=5000&limit=5"},
        {"query": "?query=Statue Of Liberty&limit=2"},
        {"query": "?query=Starbucks&lat=47.639769&lon=-122.128362&radius=5000"},
        {"query": "?query=Space Needle"},
        {"query": "?query=pizza&limit=10"}
    ]
}

Toplu iş içinde belirsiz arama sorgusu protokol, temel URL, yol, api sürümü ve abonelik anahtarı olmadan yalnızca kısmi bir URL'dir. Desteklenen herhangi bir arama belirsiz URI parametresini kabul eder. Arama belirsiz sorgusunda yer alan dize değerleri düzgün bir şekilde (örneğin " karakteri ile birlikte kaçarak) ve ayrıca DÜZGÜN URL ile \ kodlanmış olmalıdır.

Zaman uyumsuz API, çağıranın en fazla 10.000 sorguyu toplu işlemesini ve en fazla 100 sorguyu eşitleme API'sini kullanmasını sağlar ve toplu iş en az 1 sorgu içerebilir.

Zaman Uyumsuz Toplu İş Sonuçlarını İndirme

Zaman uyumsuz toplu iş sonuçlarını indirmek için toplu iş indirme GET uç noktasına bir istek gönderilir. Bu indirme URL'si, başarılı bir toplu iş Location isteğinin üst POST bilgilerinden elde edilebilir ve aşağıdaki gibi görünür:

https://atlas.microsoft.com/search/fuzzy/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}

Toplu iş sonuçlarını indirmeye yönelik tipik işlem sırası şu şekildedir:

  1. İstemci, indirme GET URL'sini kullanarak bir istek gönderir.

  2. Sunucu, aşağıdakilerden biri ile yanıt verir:

    HTTP 202 Accepted - Batch isteği kabul edildi ama hala işleniyor. Lütfen bir süre sonra yeniden deneyin.

    HTTP 200 OK - Batch isteği başarıyla işlendi. Yanıt gövdesi tüm toplu iş sonuçlarını içerir.

Toplu Yanıt Modeli

Döndürülen veri içeriği, zaman uyumsuz ve eşitleme istekleri için benzerdir. Zaman uyumsuz bir toplu iş isteğinin sonuçlarını indirirken, toplu iş işlemeyi bitirmişse yanıt gövdesi toplu iş yanıtını içerir. Bu toplu iş yanıtı, özgün toplu iş isteğinin parçası olan ve yani başarıyla yürütülen summary sorguları belirten bir bileşen totalRequests successfulRequests içerir. Toplu iş yanıtı, toplu batchItems iş isteğinde her bir sorgu için yanıt içeren bir dizi de içerir. batchItems, sonuçları toplu iş isteğinde gönderilen özgün sorguların tam olarak aynı sırayla içerir. içinde her öğe batchItems ve statusCode alanları response içerir. içinde response batchItems her biri aşağıdaki türlerden biridir:

  • SearchFuzzyResponse - Sorgu başarıyla tamamlandı ise.

  • Error - Sorgu başarısız olursa. Yanıt, bu durumda code bir ve message içerir.

2 başarılı ve 1 başarısız sonuç ile örnek bir Batch Yanıtı:

{
    "summary": {
        "successfulRequests": 2,
        "totalRequests": 3
    },
    "batchItems": [
        {
            "statusCode": 200,
            "response":
            {
                "summary": {
                    "query": "atm"
                },
                "results": [
                    {
                        "type": "POI",
                        "poi": {
                            "name": "ATM at Wells Fargo"
                        },
                        "address": {
                            "country": "United States Of America",
                            "freeformAddress": "3240 157th Ave NE, Redmond, WA 98052"
                        }
                    }
                ]
            }
        },
        {
            "statusCode": 200,
            "response":
            {
                "summary": {
                    "query": "statue of liberty"
                },
                "results": [
                    {
                        "type": "POI",
                        "poi": {
                            "name": "Statue of Liberty"
                        },
                        "address": {
                            "country": "United States Of America",
                            "freeformAddress": "New York, NY 10004"
                        }
                    }
                ]
            }
        },
        {
            "statusCode": 400,
            "response":
            {
                "error":
                {
                    "code": "400 BadRequest",
                    "message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
                }
            }
        }
    ]
}
Post Search Inside Geometry

Için geçerlidir: S0 ve S1 fiyatlandırma katmanları.

Arama Geometrisi uç noktası, tek bir geometride veya bunların birçoğunda serbest bir form araması gerçekleştirmeye olanak sağlar. Geometrinin/geometrilerin içinde yer alan arama sonuçları döndürülür.

Geometriyi göndermek için istek gövdesinin bir tür olarak temsil edilen nesneyi içerdiği ve üst bilgi olarak POST geometry GeoJSON Content-Type ayarlanır. application/json Aranacak coğrafi özellikler, aşağıdaki türlerden herhangi biri kullanılarak temsil edilen Çokgen ve/veya Daire geometrileri olarak model GeoJSON olabilir:

  • GeoJSON FeatureCollection
    geometrynesnesi olarak temsil GeoJSON FeatureCollection olabilir. Geometri hem ÇokGenler hem de Daireler içeriyorsa bu önerilen seçenektir. FeatureCollection, en fazla 50 nesne GeoJSON Feature içerebilir. Her Feature nesne, aşağıdaki koşullarla bir Çokgen veya Daireyi temsil eder:
    • Çokgen Feature geometrisi için bir nesne en fazla 50 koordinata sahip olabilir ve özellikleri boş olması gerekir.
    • Circle geometrisi için bir nesne, değeri 'Circle' olması gereken subType özelliğiyle birlikte nesnenin özelliklerinde belirtilmelidir bir tür ve yarıçap değeri (metre) kullanılarak temsil edilen bir Feature GeoJSON Point merkezden oluşur.

    Örnek gösterimi için lütfen aşağıdaki Örnekler bölümüne FeatureCollection bakın.

  • GeoJSON GeometryCollection
    geometrynesnesi olarak temsil GeoJSON GeometryCollection olabilir. Geometri yalnızca Çokgen listesi içeriyorsa bu önerilen seçenektir. GeometryCollection, en fazla 50 nesne GeoJSON Polygon içerebilir. Her Polygon nesnenin en fazla 50 koordinatı olabilir. Örnek gösterimi için lütfen aşağıdaki Örnekler bölümüne GeometryCollection bakın.

  • GeoJSON ÇokGeni
    geometrynesnesi olarak temsil GeoJSON Polygon olabilir. Geometri tek bir Çokgen içeriyorsa bu önerilen seçenektir. Nesnenin Polygon en fazla 50 koordinatı olabilir. Örnek gösterimi için lütfen aşağıdaki Örnekler bölümüne Polygon bakın.

.