Spatial

Operations

Get Buffer

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

Bu API, her Özelliğin ilgili dizine sahip Girişin bir arabelleği olduğu bir FeatureCollection döndürür. Arabellek, girişte sağlanan mesafeye bağlı olarak sağlanan Özelliğin dışında veya içinde olabilir. FeatureCollection girişine Özellik başına bir uzaklık sağlanmalıdır veya yalnızca bir uzaklık sağlanıyorsa bu uzaklık koleksiyonda yer alan tüm Özeliklere uygulanır. Bir geometrinin pozitif (veya negatif) arabelleği, geometrinin Mink sum (veya difference) olarak tanımlanır ve yarıçap dairesini arabellek uzaklığının mutlak değerine eşittir. Arabellek API'si her zaman çokgen sonuç döndürür. Satırların ve noktaların negatif veya sıfır mesafeli arabelleği her zaman boş bir çokgendir. Giriş özellikleri, Data Upload API aracılığıyla yüklenen ve benzersiz bir udid tarafından başvurulan geoJSON dosyası tarafından sağlanır. GeoJSON dosyası Point, MultiPoint, Polygon, MultiPolygon, LineString ve MultiLineString koleksiyonlarını içerebilir. Sağlanırsa GeometryCollection yoksayılır.

Bu API'yi test etmek için Data Upload API aracılığıyla Arabelleği Sonrası API örneklerinden (Uzaklık dizisi olmayan İstek Gövdesi) örnek verileri karşıya yükleyebilir ve aşağıdaki örnek istekten [udid] yerine Data Upload API tarafından döndürülen udid ile değiştirebilirsiniz.

Get Closest Point

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

Bu API, udid tarafından tanımlanan kullanıcı tarafından yüklenen veri kümesinde bir temel nokta ile belirli bir nokta kümesi arasındaki en yakın noktayı döndürür. Hedef nokta kümesi, Data Upload API aracılığıyla yüklenen ve benzersiz bir udid tarafından başvurulan bir GeoJSON dosyası tarafından sağlanır. GeoJSON dosyası yalnızca bir Nokta geometrisi koleksiyonu içerebilir. MultiPoint veya diğer geometriler sağlandı ise yoksayılır. Kabul edilen en fazla nokta sayısı 100.000'tir. Algoritma, yönlendirmeyi veya trafiği dikkate almaz. Döndürülen bilgiler arasında en yakın nokta enlem, boylam ve en yakın noktadan metre uzaklığı yer alır.

Bu API'yi test etmek için Data Upload API aracılığıyla En Yakın Noktaya Gönder API'si örneklerinden (İstek Gövdesi) örnek verileri karşıya yükleyebilir ve aşağıdaki örnek istekten [udid] yerine Data Upload API'si tarafından döndürülen udid ile değiştirebilirsiniz.

Get Geofence

Arama Coğrafi Bölge Get API'si

Aşağıdakiler için geçerlidir: S1 Fiyatlandırma katmanı.

Coğrafi Bölge Alma API'si, koordinat ile bölgeye yüklenen bir coğrafi bölgeye yakınlığı Veri hizmeti. Bir bölge sınırı veya Upload yüklemek için Data Upload API'sini kullanabilirsiniz. Coğrafi bölge veri biçimi hakkında daha fazla bilgi için bkz. GeoJSON verilerini coğrafi olarak koruma. Koordinatın yakınlıklarını sorgulamak için, izlemekte olduğunuz nesnenin konumunu ve çitlerin veya çitlerin kimliğini sağlar ve yanıt, bölge sınırın dış kenarına olan uzaklık hakkında bilgi içerir. Negatif değer koordinatı çitin içinde olduğunu, pozitif bir değerin ise çitin dışında olduğunu ifade ediyor.

Bu API varlık izleme, filo yönetimi veya nesneleri taşımaya yönelik uyarılar ayarlama gibi çeşitli senaryolar için kullanılabilir.

API, ile tümleştirmeyi Event Grid. isAsync parametresi, Event Grid tümleştirmeyi etkinleştirmek için kullanılır (varsayılan olarak devre dışıdır). Bu API'yi test etmek için Veri Upload API'si aracılığıyla Coğrafi Bölge Sonrası API örneklerinden (İstek Gövdesi) örnek verileri karşıya yükleyebilir ve aşağıdaki örnek istekten [udid] yerine Data Upload API tarafından döndürülen udid ile değiştirebilirsiniz.

InnerError kodunu coğrafi olarak zorlama

Yanıt hata sözleşmesini coğrafi olarak zorlamada, innererror hata hakkında hizmete özgü bilgileri içeren bir nesnedir. code , belirli bir innererror coğrafi bölgeye yönelik hata türüne eşlene bir özelliktir. Aşağıdaki tabloda, bilinen tüm istemci hata türü arasındaki kod eşlemesi karşılık gelen coğrafi savunma hatasıyla message gösterilmiştir.

innererror.code error.message
NullDeviceId Cihaz Kimliği null olmamalıdır.
NullUdid Udid null olmamalıdır.
UdidWrongFormat Udid, kullanıcı veri alımı API'lerinden alınarak elde etmek gerekir.
InvalidUserTime Usertime geçersiz.
InvalidSearchBuffer Searchbuffer geçersiz.
InvalidSearchRange searchbuffer değerinin 0 ile 500 metre arasında olması gerekir.
InvalidLatLon Lat ve/veya lon parametreleri geçersiz.
InvalidIsAsyncValue IsAsync parametresi geçersiz.
InvalidModeValue Mode parametresi geçersiz.
InvalidJson Verileri coğrafi olarak dışlama geçerli bir json dosyası değildir.
NotSupportedGeoJson Coğrafi bölgeye yönelik veriler Özellik veya FeatureCollections olarak okunmaz.
InvalidGeoJson Verileri coğrafi olarak dışlama geçersiz.
NoUserDataWithAccountOrSubscription Sağlanan account-id ve/veya subscription-id ile kullanıcı coğrafi olarak ilgili verileri bulamıyorum.
NoUserDataWithUdid Sağlanan udId ile kullanıcı coğrafi olarak dışlama verileri bulamıyorum.
Get Great Circle Distance

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

Bu API, bir kürenin yüzeyindeki iki nokta arasındaki büyük daireyi veya en kısa mesafeyi, kürenin yüzeyi boyunca ölçülür. Bu, kürenin iç tarafından düz bir çizginin hesaplanmasından farklıdır. Bu yöntem, havaalanı arasındaki en kısa mesafeyi hesap ederek uçaklar için seyahat mesafelerini tahmin etmek için yararlıdır.

Get Point In Polygon

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

Bu API, bir noktanın bir çokgen kümesi içinde olup olmadığını belirten bir boole değeri döndürür. Çokgen kümesi, Data Upload API aracılığıyla yüklenen ve benzersiz bir udid tarafından başvurulan geoJSON dosyası tarafından sağlanır. GeoJSON dosyası Çokgen ve ÇokGen geometrileri içerebilir, sağlanırsa diğer geometriler yoksayılır. Nokta bu çokgenlerden birinin içinde veya sınırındaysa döndürülen değer true olur. Diğer tüm durumlarda döndürülen değer false olur. Nokta birden çok çok poligon içinde olduğunda sonuç, kullanıcı verilerinde tüm geçerli geometrileri (geometryId tarafından başvurulan) göstermek için kesişen geometriler bölümü verir. Çokgen oluşturmak için kabul edilen en fazla köşe sayısı 10.000'tir.

Bu API'yi test etmek için Data Upload API aracılığıyla Post Point In Polygon API örneklerinden (İstek Gövdesi) örnek verileri karşıya yükleyebilir ve aşağıdaki örnek istekten [udid] yerine Data Upload API tarafından döndürülen udid ile değiştirebilirsiniz.

Post Buffer

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

Bu API, her Özelliğin ilgili dizine sahip Girişin bir arabelleği olduğu bir FeatureCollection döndürür. Arabellek, girişte sağlanan mesafeye bağlı olarak sağlanan Özelliğin dışında veya içinde olabilir. FeatureCollection girişine Özellik başına bir uzaklık sağlanmalıdır veya yalnızca bir uzaklık sağlanıyorsa bu uzaklık koleksiyonda yer alan tüm Özeliklere uygulanır. Bir geometrinin pozitif (veya negatif) arabelleği, geometrinin Mink sum (veya difference) olarak tanımlanır ve yarıçap dairesini arabellek uzaklığının mutlak değerine eşittir. Arabellek API'si her zaman çokgen sonuç döndürür. Satırların ve noktaların negatif veya sıfır mesafeli arabelleği her zaman boş bir çokgendir. Giriş; Point, MultiPoint, Polygon, MultiPolygon, LineString ve MultiLineString koleksiyonlarını içerebilir. Sağlanırsa GeometryCollection yoksayılır.

Post Closest Point

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

Bu API, bir temel nokta ile belirli bir hedef nokta kümesi arasındaki en yakın noktayı döndürür. Hedef nokta kümesi, istek sonrası gövdesinde kullanıcı verileri tarafından sağlanır. Kullanıcı verileri yalnızca bir Nokta geometrisi koleksiyonu içerebilir. MultiPoint veya diğer geometriler sağlandı ise yoksayılır. Algoritma, yönlendirmeyi veya trafiği dikkate almaz. Kabul edilen en fazla nokta sayısı 100.000'tir. Döndürülen bilgiler arasında en yakın nokta enlem, boylam ve en yakın noktadan metre uzaklığı yer alır.

Post Geofence

Coğrafi Bölge Sonrası API'sini arama Aşağıdakiler için geçerlidir: S1 Fiyatlandırma katmanı. Geofence Post API'si, bir koordinata yakınlığı sağlanan bir bölge sınırı veya çit kümesine alasınız. POST çağrısıyla, çit verilerini önceden karşıya yüklemek zorunda değil, bunun yerine sorgu parametrelerinde izlemekte olduğunu nesnenin konumunu ve istek sonrası gövdesinde çit veya çit kümesi verilerini sağlarız. Bölge verileri biçimi hakkında daha fazla bilgi için bkz. bölge sınırlama coğrafi JSON verileri . Yanıt, bölge alanının dış kenarından olan mesafe hakkındaki bilgileri içerir. Negatif bir değer, koordinat sınırının içinde olduğunu, pozitif bir değer ise sınırının dışına geldiğini belirtir.

Bu API, varlık izleme, filo yönetimi gibi şeyleri veya nesneleri taşımak için uyarıları ayarlamayı içeren çeşitli senaryolar için kullanılabilir.

API Event Grid ile tümleştirmeyidestekler. IsAsync parametresi, Event Grid tümleştirmeyi etkinleştirmek için kullanılır (varsayılan olarak devre dışıdır).

Post Point In Polygon

Uygulama hedefi: S1 fiyatlandırma katmanı.

Bu API, bir noktanın bir çokgenler kümesi içinde olup olmadığını gösteren bir Boole değeri döndürür. Kullanıcı verileri Çokgen ve MultiPolygon geometrileri içerebilir, sağlanmışsa diğer geometriler de yok sayılır. Nokta bu poligonun içindeyse veya sınırında olursa döndürülen değer true 'dur. Diğer tüm durumlarda döndürülen değer false 'tur. Nokta birden çok poligonun içindeyse, sonuç, Kullanıcı verilerinde geçerli tüm geometrilerin (Geometryıd tarafından başvurulan) gösterilmesi için kesişerek kesişen geometriler bölümüne sahip olur. Bir çokgen oluşturmak için kabul edilen en fazla köşe sayısı 10.000 ' dir.