@azure-rest/maps-search package

Sonucun adresi

GeoJSON GeocodingFeature bir coğrafi alanın sınırlarını açıklayan nesne. Özelliğin geometrisi GeoJSON GeometryCollectionile açıklanmıştır.

Hizmetin genellikle Polygon veya MultiPolygon alt türlerine sahip bir GeometryCollection döndürdüğüne dikkat edin.

Sınır nesnesinin özellikleri.

Kaynak yönetimi hatası ek bilgileri.

Hata ayrıntısı.

Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).

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

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

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

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.

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

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

GeoJson MultiPointtarafından kapsanan veriler.

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

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

Geçerli bir GeoJSON nesnesi. Ayrıntılar için lütfen RFC 7946 bakın.

GeoJson Pointtarafından kapsanan veriler.

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

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

İşlenmesi gereken adres coğrafi kodlama sorgularının/isteklerinin listesi. Liste en fazla 100 sorgu içerebilir ve en az 1 sorgu içermelidir.

Batch Query nesnesi

Bu nesne başarılı bir Geocoding Batch hizmet çağrısından döndürülür.

Toplu iş isteğinin özeti

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

Sınır nesnesinin geometrisinin telif hakkı bilgileri.

Sonucun adresi.

İstemci için isteğe bağlı parametreler

İşlenmesi gereken ters coğrafi kodlama sorgularının/isteklerinin listesi. Liste en fazla 100 sorgu içerebilir ve en az 1 sorgu içermelidir.

Batch Query nesnesi

Get Geocoding API,aranmakta olan konumun boylam ve enlem koordinatlarını döndüren bir HTTP GET isteğidir.

Çoğu durumda, yalnızca geleneksel coğrafi kodlamayla ilgileniyorsanız, tam arama hizmeti çok fazla olabilir. Yalnızca adres arama için de arama yapılabilir. Coğrafi kodlama, yalnızca söz konusu adres veya kısmi adresle coğrafi kodlama uç noktasına isabet ederek gerçekleştirilir. Coğrafi kodlama arama dizini, sokak düzeyindeki verilerin üzerindeki her şey için sorgulanır. İlgi Noktası (POI) döndürülmeyecek. Coğrafi kodlayıcının yazım hatalarına ve eksik adreslere çok dayanıklı olduğunu unutmayın. Ayrıca sokak adreslerinden, sokak veya kavşaklardan ve şehir merkezleri, ilçeler ve eyaletler gibi daha üst düzey coğrafyalardan her şeyi ele alacaktır. Yanıt ayrıca sokak, posta kodu, belediye ve ülke/bölge bilgileri gibi ayrıntılı adres özelliklerini döndürür.

Get Geocoding Batch API,POST API'sine tek bir istekte en fazla 100 sorgu gönderen bir HTTP isteğidir.

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

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 zaman aşımı hatası (408 yanıtı) döndürür. Toplu iş öğelerinin sayısı, bu API için 100 ile sınırlıdır.

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

Toplu İstek için POST Gövdesi

coğrafi kodlama sorguları göndermek için, istek gövdesinin POST dizisini batchItems biçimde içereceği ve json üst bilgisinin Content-Typeolarak ayarlanacağı application/json bir istek kullanırsınız. 2 coğrafi kodlama sorgu içeren örnek bir istek gövdesi aşağıda verilmişti:

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

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

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

Batch Yanıt Modeli

Toplu yanıt, özgün toplu iş isteğinin parçası olan summary belirten bir totalRequests bileşeni ve başarıyla yürütülen sorgular successfulRequests içerir. Toplu yanıt, toplu iş isteğindeki her sorgu için bir yanıt içeren bir batchItems dizisi de içerir. batchItems, sonuçları özgün sorguların toplu iş isteğinde gönderildiği sırayla 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 bir message içerir.

Get Geocoding Batch API,POST API'sine tek bir istekte en fazla 100 sorgu gönderen bir HTTP isteğidir.

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

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 zaman aşımı hatası (408 yanıtı) döndürür. Toplu iş öğelerinin sayısı, bu API için 100 ile sınırlıdır.

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

Toplu İstek için POST Gövdesi

coğrafi kodlama sorguları göndermek için, istek gövdesinin POST dizisini batchItems biçimde içereceği ve json üst bilgisinin Content-Typeolarak ayarlanacağı application/json bir istek kullanırsınız. 2 coğrafi kodlama sorgu içeren örnek bir istek gövdesi aşağıda verilmişti:

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

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

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

Batch Yanıt Modeli

Toplu yanıt, özgün toplu iş isteğinin parçası olan summary belirten bir totalRequests bileşeni ve başarıyla yürütülen sorgular successfulRequests içerir. Toplu yanıt, toplu iş isteğindeki her sorgu için bir yanıt içeren bir batchItems dizisi de içerir. batchItems, sonuçları özgün sorguların toplu iş isteğinde gönderildiği sırayla 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 bir message içerir.

Get Geocoding API,aranmakta olan konumun boylam ve enlem koordinatlarını döndüren bir HTTP GET isteğidir.

Çoğu durumda, yalnızca geleneksel coğrafi kodlamayla ilgileniyorsanız, tam arama hizmeti çok fazla olabilir. Yalnızca adres arama için de arama yapılabilir. Coğrafi kodlama, yalnızca söz konusu adres veya kısmi adresle coğrafi kodlama uç noktasına isabet ederek gerçekleştirilir. Coğrafi kodlama arama dizini, sokak düzeyindeki verilerin üzerindeki her şey için sorgulanır. İlgi Noktası (POI) döndürülmeyecek. Coğrafi kodlayıcının yazım hatalarına ve eksik adreslere çok dayanıklı olduğunu unutmayın. Ayrıca sokak adreslerinden, sokak veya kavşaklardan ve şehir merkezleri, ilçeler ve eyaletler gibi daha üst düzey coğrafyalardan her şeyi ele alacaktır. Yanıt ayrıca sokak, posta kodu, belediye ve ülke/bölge bilgileri gibi ayrıntılı adres özelliklerini döndürür.

Get Polygon API'si, şehir veya ülke bölgesi gibi bir coğrafi alan ana hattının çokgen verilerini sağlayan bir HTTP GET isteğidir.

Get Polygon API'si, şehir veya ülke bölgesi gibi bir coğrafi alan ana hattının çokgen verilerini sağlayan bir HTTP GET isteğidir.

Get Reverse Geocoding API'si, bir koordinatı (örneğin: 37.786505, -122.3862) anlaşılır bir sokak adresine çevirmek için kullanılan bir HTTP GET isteğidir. Cihazdan veya varlıktan GPS akışı aldığınız ve koordinatlarla ilişkili adresi bilmek istediğiniz uygulamaları izlemede yararlıdır. Bu uç nokta, belirli bir koordinat için adres bilgilerini döndürür.

API'si, tek bir istek kullanarak Ters Coğrafi Kodlama API'sine 100'e kadar sorgu içeren toplu işlemler gönderen bir HTTP isteğidir.

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

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 zaman aşımı hatası (408 yanıtı) döndürür. Toplu iş öğelerinin sayısı, bu API için 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ı göndermek için, istek gövdesinin dizisini biçimde içereceği ve üst bilgisinin olarak ayarlanacağı bir istek kullanırsınız. Aşağıda 2 ters coğrafi kodlama sorgu 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.

Batch Yanıt Modeli

Toplu yanıt, özgün toplu iş isteğinin parçası olan summary belirten bir totalRequests bileşeni ve başarıyla yürütülen sorgular successfulRequests içerir. Toplu yanıt, toplu iş isteğindeki her sorgu için bir yanıt içeren bir batchItems dizisi de içerir. batchItems, sonuçları özgün sorguların toplu iş isteğinde gönderildiği sırayla 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 bir message içerir.

API'si, tek bir istek kullanarak Ters Coğrafi Kodlama API'sine 100'e kadar sorgu içeren toplu işlemler gönderen bir HTTP isteğidir.

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

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 zaman aşımı hatası (408 yanıtı) döndürür. Toplu iş öğelerinin sayısı, bu API için 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ı göndermek için, istek gövdesinin dizisini biçimde içereceği ve üst bilgisinin olarak ayarlanacağı bir istek kullanırsınız. Aşağıda 2 ters coğrafi kodlama sorgu 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.

Batch Yanıt Modeli

Toplu yanıt, özgün toplu iş isteğinin parçası olan summary belirten bir totalRequests bileşeni ve başarıyla yürütülen sorgular successfulRequests içerir. Toplu yanıt, toplu iş isteğindeki her sorgu için bir yanıt içeren bir batchItems dizisi de içerir. batchItems, sonuçları özgün sorguların toplu iş isteğinde gönderildiği sırayla 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 bir message içerir.

Get Reverse Geocoding API'si, bir koordinatı (örneğin: 37.786505, -122.3862) anlaşılır bir sokak adresine çevirmek için kullanılan bir HTTP GET isteğidir. Cihazdan veya varlıktan GPS akışı aldığınız ve koordinatlarla ilişkili adresi bilmek istediğiniz uygulamaları izlemede yararlıdır. Bu uç nokta, belirli bir koordinat için adres bilgilerini döndürür.

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

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.

Geçerli bir GeoJSON nesnesi. Ayrıntılar için lütfen RFC 7946 bakın.

Bir abonelik anahtarından HaritalarSearchClient örneği oluşturur.

Örnek

import MapsSearch from "@azure-rest/maps-search";
import { AzureKeyCredential } from "@azure/core-auth";

const credential = new AzureKeyCredential("<subscription-key>");
const client = MapsSearch(credential);

Bir Azure Identity TokenCredential'ndan MapsSearch örneği oluşturur.

Örnek

import MapsSearch from "@azure-rest/maps-search";
import { DefaultAzureCredential } from "@azure/identity";

const credential = new DefaultAzureCredential();
const client = MapsSearch(credential, "<maps-account-client-id>");

Bir Azure Identity AzureSASCredential'ndan MapsSearch örneği oluşturur.

Örnek

import MapsSearch from "@azure-rest/maps-search";
import { AzureSASCredential } from "@azure/core-auth";

const credential = new AzureSASCredential("<SAS Token>");
const client = MapsSearch(credential);