Features - Get Items

Başvuru

Hizmet:: Maps Creator

API Sürümü:: 2023-03-01-preview

Belirtilen özellik koleksiyonundaki özelliklerin ayrıntılı listesini almak için kullanın.

Not

Azure Haritalar Creator'ın kullanımdan kaldırılması

Azure Haritalar Oluşturucu iç mekan harita hizmeti artık kullanım dışıdır ve 30.09.25 tarihinde kullanımdan kaldırılacaktır. Daha fazla bilgi için bkz. Azure Haritalar Oluşturucunun Kullanım Süresi Sonu Duyurusu.

Özellikler API'Creator'nin bir parçasıdır. Bu, Azure Haritalar API'sini ve SDK'sını kullanarak özel iç mekan harita verilerinize göre uygulama geliştirmeyi mümkün kılar. Özellikler GET API'leri Açık Jeo-Uzamsal Konsorsiyum API'sini izler - Özellikler - Bölüm 1: Çekirdek corrigendum standart Veri Kümelerini sorgulamak. Veri kümeleri, ortak bir şema tarafından tanımlanan özelliklerden oluşan bir grup olan birden çok özellik koleksiyonundan oluşur.

Öğe Alma İsteği Gönder

Get Items API,belirtilen veri kümesinde sağlanan GET tarafından tanımlanan özellik koleksiyonundaki özellikleri döndüren bir HTTP collectionId isteğidir.

GET https://{geography}.atlas.microsoft.com/features/datasets/{datasetId}/collections/{collectionId}/items?api-version=2023-03-01-preview

İsteğe bağlı parametrelerle:

GET https://{geography}.atlas.microsoft.com/features/datasets/{datasetId}/collections/{collectionId}/items?api-version=2023-03-01-preview&limit={limit}&bbox={bbox}&filter={filter}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
collectionId	path	True	string	Belirli bir koleksiyonun tanımlayıcısı (ad).
datasetId	path	True	string	Sorguya alınacak veri kümesinin tanımlayıcısı.
geography	path	True	string	Bu parametre, Azure Haritalar Oluşturucu kaynağının nerede bulunduğunu belirtir. Geçerli değerler biz ve AB'dir.
api-version	query	True	string	Azure Haritalar API'sinin sürüm numarası.
bbox	query		number[]	Yalnızca sağlanan sınırlayıcı kutuyla kesişen geometrisi olan özellikler seçilir. Sol alt köşe, koordinat ekseni 1 * Sol alt köşe, koordinat ekseni 2 * Sağ üst köşe, koordinat ekseni 1 * Sağ üst köşe, koordinat ekseni 2 Değerlerin koordinat başvuru sistemi, http://www.opengis.net/def/crs/OGC/1.3/CRS84parametresinde farklı bir koordinat başvuru sistemi belirtilmediği sürece WGS84 boylamı/enlemidir (`bbox-crs`). WGS84 boylamı/enlemi için değerler çoğu durumda minimum boylam, minimum enlem, maksimum boylam ve enlem dizisidir. Ancak, kutunun antimeridyene yayıldığı durumlarda ilk değer (batı-en kutu kenarı) üçüncü değerden (doğu-en kutu kenarı) büyüktür.
filter	query		string	Belirli bir koleksiyondaki belirli özellik değerlerine sahip özellikleri aramak için ifadeyi filtreleyin. Yalnızca skaler türü ve eşittir işlecinin özellik özellikleri desteklenir. Bu, parametre adının büyük/küçük harfe duyarlı özellik adı olduğu özel bir parametredir. Bu parametrenin düzeni {özellik adı}={özellik değeri}'dir. Koleksiyondaki özellik adlarından biri "filter" değilse, parametre adı olarak "filter" kullanılmamalıdır. "name" özellik değeri "21N13" olan özellikleri aramak için "name=21N13" kullanın. Birden çok filtre desteklenir ve birden çok sorgu parametresi olarak temsil edilmelidir. Örneğin, =&= Dize değerleri büyük/küçük harfe duyarlıdır.
limit	query		integer (int32) minimum: 1 maximum: 5000	İsteğe bağlı limit parametresi, yanıt belgesinde sunulan özelliklerin sayısını sınırlar. Yalnızca yanıt belgesindeki koleksiyonun ilk düzeyindeki özellikler sayılır. Açıkça istenen özelliklerin içinde yer alan iç içe nesneler sayılmamalıdır. Minimum = 1 * Maksimum = 500 * Varsayılan = 10

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-id		string	Microsoft Entra Id güvenlik modeliyle birlikte hangi hesabın 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'da Microsoft Entra ID güvenliğini kullanmak için rehberlik için aşağıdaki makalelerine bakın.

Yanıtlar

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

Güvenlik

AADToken

Bunlar Azure Active Directory OAuth2 Akışlarının. 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ğına erişim belirtmek 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çinkimlik 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.

Notlar

Bu güvenlik tanımı kullanılmasını gerektirir. Bu, Haritalar yönetim API'sindenedinilebilir.

Authorization URL, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Azure Active Directory 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üzlemi yapılandırılır. * Azure Haritalar Web SDK kullanımı, bir uygulamanın birden çok kullanım örneği için yapılandırma tabanlı kurulumuna olanak tanır.

Şu anda Azure Active Directory v1.0 veya v2.0 İş, Okul ve Konuklar'ı destekler ancak Kişisel hesapları desteklemez.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

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 bir Azure Haritalar kaynağı oluşturulurken 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 değerlendirilebilir.

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şimini kullanmaktır.

Tür: apiKey
İçinde: query

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ğı Sas Listeleme işleminden oluşturulur.

Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirteç için kullanım süre sonu, oran ve bölgelere ayrıntılı denetim ile erişim yetkisine sahiptir. 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, Eşleme hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemektir.

Tür: apiKey
İçinde: header

Örnekler

GetFeatures

Örnek isteği

HTTP

GET https://us.atlas.microsoft.com/features/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items?api-version=2023-03-01-preview&limit=1&bbox=-122,47,-120,46

Örnek yanıt

Durum kodu:: 200

{
  "type": "FeatureCollection",
  "ontology": "facility-2.0",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              139.6330405782921,
              35.45768668610856
            ],
            [
              139.63296283234274,
              35.45778390425868
            ],
            [
              139.63308672404617,
              35.45785022906202
            ],
            [
              139.6331451691671,
              35.45777714569986
            ],
            [
              139.6331274703629,
              35.45776767074717
            ],
            [
              139.63314677109963,
              35.45774353588138
            ],
            [
              139.6330405782921,
              35.45768668610856
            ]
          ]
        ]
      },
      "properties": {
        "originalId": "ddbbb583-4621-4e11-8859-299d1057e843",
        "categoryId": "CTG10",
        "isOpenArea": false,
        "isRoutable": false,
        "levelId": "LVL18",
        "occupants": [],
        "addressId": "DIR16",
        "name": "21N13"
      },
      "id": "UNIT39"
    }
  ],
  "numberReturned": 1,
  "links": [
    {
      "href": "https://us.atlas.microsoft.com/features/datasets/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items?limit=1",
      "rel": "self",
      "title": "Unit"
    },
    {
      "href": "https://us.atlas.microsoft.com/features/datasets/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit",
      "rel": "collection",
      "title": "Information for unit collection"
    },
    {
      "href": "https://us.atlas.microsoft.com/features/datasets/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items?n=PMRG4ZLYOQRDUMJMEJYHEZLWEI5C2ML5&limit=1",
      "rel": "next",
      "title": "Next page"
    }
  ]
}

Tanımlar

Name	Description
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ExtendedGeoJsonFeatureCollection	numberReturned ve links dizisiyle genişletilmiş geçerli bir `GeoJSON FeatureCollection` nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.
Feature	Geçerli bir `GeoJSON Feature` nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.
FeaturesEndpointLink	Diğer Özellikler uç noktalarına bağlantılar. Bağlantı ilişkileri hakkında daha fazla bilgi için lütfen OGC API - Özellikler - Bölüm 1 standardını ziyaret edin.
GeoJsonGeometry	Geçerli bir `GeoJSON` geometri nesnesi. Tür yedi geçerli GeoJSON geometri türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon ve GeometryCollection. Ayrıntılar için lütfen RFC 7946 bakın.
GeoJsonGeometryCollection	Geçerli bir `GeoJSON GeometryCollection` nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.
GeoJsonLineString	Geçerli bir `GeoJSON LineString` geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
GeoJsonMultiLineString	Geçerli bir `GeoJSON MultiLineString` geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
GeoJsonMultiPoint	Geçerli bir `GeoJSON MultiPoint` geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
GeoJsonMultiPolygon	Geçerli bir `GeoJSON MultiPolygon` nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.
GeoJsonObjectType	`GeoJSON` türünü belirtir: FeatureCollection.
GeoJsonPoint	Geçerli bir `GeoJSON Point` geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
GeoJsonPolygon	Geçerli bir `GeoJSON Polygon` geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

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

ErrorDetail

Object

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

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ExtendedGeoJsonFeatureCollection

Object

numberReturned ve links dizisiyle genişletilmiş geçerli bir GeoJSON FeatureCollection nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.

Name	Tür	Description
features	Feature[]	Geçerli `GeoJSON Feature` nesnelerinin listesini içerir.
links	FeaturesEndpointLink[]	Diğer Özellikler uç noktalarına bağlantılar.
numberReturned	integer (int32)	Döndürülen özellik sayısı.
ontology	string	Bu veri kümesinin ontoloji sürümü.
type	GeoJsonObjectType	`GeoJSON` türünü belirtir: FeatureCollection.

Feature

Object

Geçerli bir GeoJSON Feature nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.

Name	Tür	Description
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Geçerli bir `GeoJSON` geometri nesnesi. Tür yedi geçerli GeoJSON geometri türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon ve GeometryCollection. Ayrıntılar için lütfen RFC 7946 bakın.
id	string	Belirli bir özelliğin büyük/küçük harfe duyarlı tanımlayıcısı.
properties	object	Özellikler, `Feature` hakkında ek meta veriler içerebilir ve GET Koleksiyon Tanımı API'si tarafından tanımlanır. Değer herhangi bir JSON nesnesi veya JSON null değeri olabilir, ancak koleksiyon tanımında tanımlanmayan özellik özelliklerinin yoksayılacağını lütfen unutmayın.
type	string	`GeoJSON` türünü belirtir: Özellik

FeaturesEndpointLink

Object

Diğer Özellikler uç noktalarına bağlantılar. Bağlantı ilişkileri hakkında daha fazla bilgi için lütfen OGC API - Özellikler - Bölüm 1 standardını ziyaret edin.

Name	Tür	Description
href	string (uri)	Bağlantı hedefi.
rel	string	İlişki türü.
title	string	Bir bağlantının hedefini, İçerik Dili üst bilgi alanı (varsa) tarafından belirtilen dilde insan tarafından okunabilir bir tanımlayıcı (örneğin, menü girdisi) olarak kullanılabilecek şekilde etiketlemek için kullanılır.

GeoJsonGeometry

Object

Geçerli bir GeoJSON geometri nesnesi. Tür yedi geçerli GeoJSON geometri türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon ve GeometryCollection. Ayrıntılar için lütfen RFC 7946 bakın.

Name	Tür	Description
type	GeoJsonObjectType	`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.

GeoJsonGeometryCollection

Object

Geçerli bir GeoJSON GeometryCollection nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.

Name	Tür	Description
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	Geçerli `GeoJSON` geometri nesnelerinin listesini içerir. GeoJSON'daki koordinatların x, y sırada (boylam, enlem) olduğunu.
type	string: GeometryCollection	`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.

GeoJsonLineString

Object

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

Name	Tür	Description
coordinates	number[] (double)	`GeoJson LineString` geometrisinin koordinatları.
type	string: LineString	`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.

GeoJsonMultiLineString

Object

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

Name	Tür	Description
coordinates	number[] (double)	`GeoJson MultiLineString` geometrisinin koordinatları.
type	string: MultiLineString	`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.

GeoJsonMultiPoint

Object

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

Name	Tür	Description
coordinates	number[] (double)	`GeoJson MultiPoint` geometrisinin koordinatları.
type	string: MultiPoint	`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.

GeoJsonMultiPolygon

Object

Geçerli bir GeoJSON MultiPolygon nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.

Name	Tür	Description
coordinates	number[] (double)	Geçerli `GeoJSON Polygon` nesnelerinin listesini içerir. GeoJSON'daki koordinatların x, y sırada (boylam, enlem) olduğunu.
type	string: MultiPolygon	`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.

GeoJsonObjectType

Listeleme

GeoJSON türünü belirtir: FeatureCollection.

Değer	Description
FeatureCollection	`GeoJSON FeatureCollection` nesne.

GeoJsonPoint

Object

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

Name	Tür	Description
coordinates	number[] (double)	`Position`, iki veya daha fazla öğe içeren bir sayı dizisidir. İlk iki öğe boylam ve enlemtam olarak bu sıradadır. Yükseklik/Yükseltme isteğe bağlı bir üçüncü öğedir. Ayrıntılar için lütfen RFC 7946 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.

GeoJsonPolygon

Object

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

Name	Tür	Description
coordinates	number[] (double)	`GeoJson Polygon` geometri türü için koordinatlar.
type	string: Polygon	`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.

Aracılığıyla paylaş

Features - Get Items

Öğe Alma İsteği Gönder

URI Parametreleri

İstek Başlığı

Yanıtlar

Güvenlik

AADToken

Notlar

Kapsamlar

subscription-key

SAS Token

Örnekler

GetFeatures

Örnek isteği

Örnek yanıt

Tanımlar

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedGeoJsonFeatureCollection

Feature

FeaturesEndpointLink

GeoJsonGeometry

GeoJsonGeometryCollection

GeoJsonLineString

GeoJsonMultiLineString

GeoJsonMultiPoint

GeoJsonMultiPolygon

GeoJsonObjectType

GeoJsonPoint

GeoJsonPolygon