Search - Get Geocoding

Hizmet:: Maps

API Sürümü:: 2026-01-01

Bir sokak adresinin veya bir yerin adının enlem ve boylam koordinatlarını almak için kullanın.
API Get Geocoding , aranan konumun enlem ve boylam 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, coğrafi kodlama uç noktasına yalnızca söz konusu adres veya kısmi adresle ulaşılarak gerçekleştirilir. Coğrafi kodlama arama dizini, sokak düzeyindeki verilerin üzerindeki her şey için sorgulanır. Hiçbir İlgi Çekici Nokta (POI) iade edilmeyecektir. Coğrafi kodlayıcının yazım hatalarına ve eksik adreslere çok dayanıklı olduğunu unutmayın. Ayrıca, tam sokak adreslerinden veya sokak veya kavşaklardan şehir merkezleri, ilçeler ve eyaletler gibi daha üst düzey coğrafyalara kadar her şeyi ele alacaktır. Yanıt ayrıca sokak, posta kodu, belediye ve ülke/bölge bilgileri gibi ayrıntılı adres özelliklerini de döndürür.

GET {endpoint}/geocode?api-version=2026-01-01

İsteğe bağlı parametrelerle:

GET {endpoint}/geocode?api-version=2026-01-01&top={top}&query={query}&addressLine={addressLine}&countryRegion={countryRegion}&bbox={bbox}&view={view}&coordinates={coordinates}&adminDistrict={adminDistrict}&adminDistrict2={adminDistrict2}&adminDistrict3={adminDistrict3}&locality={locality}&postalCode={postalCode}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	Azure Haritalar service hostname. Azure açık bulut için `https://atlas.microsoft.com` kullanın. Belirli bir Azure Haritalar coğrafyası veya egemen bir bulutu hedeflemek için Azure Haritalar coğrafi kapsam bkz.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
addressLine	query		string	Bir adresin, bölgeye göre resmi sokak çizgisi, bölge veya posta kodu özellikleri tarafından belirtildiği şekilde. Bu öğenin tipik kullanımı, bir sokak adresi veya herhangi bir resmi adres sağlamak olacaktır. Parametre isteğe dahil edildiğinde `query` bu parametre kullanılmamalıdır.
adminDistrict	query		string	Bir adresin WA gibi ülke alt bölümü bölümü. Parametre isteğe dahil edildiğinde `query` bu parametre kullanılmamalıdır.
adminDistrict2	query		string	Yapılandırılmış adresin ilçesi, örneğin King. Parametre isteğe dahil edildiğinde `query` bu parametre kullanılmamalıdır.
adminDistrict3	query		string	Yapılandırılmış adres için adlandırılmış alan. Parametre isteğe dahil edildiğinde `query` bu parametre kullanılmamalıdır.
bbox	query		number[]	Yeryüzünde sınırlayıcı kutu nesnesi olarak tanımlanan dikdörtgen bir alan. Dikdörtgenin kenarları boylam ve enlem değerleriyle tanımlanır. Bu parametreyi belirttiğinizde, bir konum sorgusunun sonuçları hesaplanırken coğrafi alan dikkate alınır. Örnek: lon1,enlem1,boylam2,enlem2. Minimum boyut: yaklaşık 0,00001 derece (~0,01 metre). Maksimum boyut: tüm küresel kapsama kadar (-180,-90 ila 180,90)
coordinates	query		number[]	Dünya üzerinde boylam ve enlem olarak belirtilen bir nokta. Bu parametreyi belirttiğinizde, kullanıcının konumu dikkate alınır ve döndürülen sonuçlar kullanıcıyla daha ilgili olabilir. Örnek: &koordinatları=lon,lat
countryRegion	query		string	Coğrafi kodlama sonucu için belirtilen ISO 3166-1 Alfa-2 bölge/ülke koduna sinyal verin, örneğin FR. Parametre isteğe dahil edildiğinde `query` bu parametre kullanılmamalıdır.
locality	query		string	Seattle gibi bir adresin konum kısmı. Parametre isteğe dahil edildiğinde `query` bu parametre kullanılmamalıdır.
postalCode	query		string	Bir adresin posta kodu kısmı. Parametre isteğe dahil edildiğinde `query` bu parametre kullanılmamalıdır.
query	query		string	Adres veya yer işareti adı gibi bir konum hakkında bilgi içeren bir dize.
top	query		integer (int32) minimum: 1 maximum: 20	Döndürülecek en fazla yanıt sayısı. Varsayılan: 5, minimum: 1 ve maksimum: 20.
view	query		string	ISO 3166-1 Alfa-2 bölge/ülke kodunutemsil eden bir dize. Bu, jeopolitik ihtilaflı kenarlıkları ve etiketleri belirtilen kullanıcı bölgesiyle uyumlu olacak şekilde değiştirir. Varsayılan olarak, görünüm parametresi istekte tanımlamamış olsanız bile "Otomatik" olarak ayarlanır. Ayrıntılar ve kullanılabilir Görünümleri görmek için lütfen Desteklenen Görünümler bakın.

İstek Başlığı

Name	Gerekli	Tür	Description
Accept-Language		string	Arama sonuçlarının döndürülmesi gereken dil. Ayrıntılar için lütfen Desteklenen Diller bakın.
x-ms-client-id		string	Azure AD güvenlik modeliyle birlikte hangi hesabın kullanılacağını belirtir. Bu cihaz, Azure Haritalar hesabı için benzersiz bir kimlik oluşturur ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'de Microsoft Entra ID güvenliği kullanımı hakkında daha fazla bilgi için bkz. Doğrulamayı Azure Haritalar içinde yönetin.

Name

Gerekli

Tür

Description

Accept-Language

string

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

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

x-ms-client-id

string

Azure AD güvenlik modeliyle birlikte hangi hesabın kullanılacağını belirtir. Bu cihaz, Azure Haritalar hesabı için benzersiz bir kimlik oluşturur ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'de Microsoft Entra ID güvenliği kullanımı hakkında daha fazla bilgi için bkz. Doğrulamayı Azure Haritalar içinde yönetin.

Yanıtlar

Name	Tür	Description
200 OK	GeocodingResponse	İstek başarılı oldu. Media Types: "application/geo+json", "application/json"
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Beklenmeyen bir hata yanıtı. Media Types: "application/geo+json", "application/json" Üst Bilgiler x-ms-error-code: string

Name

Tür

Description

200 OK

GeocodingResponse

İstek başarılı oldu.

Media Types: "application/geo+json", "application/json"

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Beklenmeyen bir hata yanıtı.

Media Types: "application/geo+json", "application/json"

Üst Bilgiler

x-ms-error-code: string

Güvenlik

AadToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim kontrolüyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi kontrol etmek için kullanılabilir. Azure rol tabanlı erişim kontrolleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağa erişim belirlemek 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.

Note

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. Egemen bulutlar benzersiz Yetkilendirme URL'lerine ve Microsoft Entra ID yapılandırmalarına sahiptir.
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 platformuna genel bakış.

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

Kapsamlar

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

subscription-key

Bu, Azure portalında Azure Haritalar hesabı oluşturma veya PowerShell, CLI, Azure SDK'ları veya REST API kullanarak sağlanan paylaşılan bir anahtardır.

Bu anahtarla, tüm uygulamalar tüm REST API'lere erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.

Herkese açık uygulamalar için, anahtarınızın güvenli bir şekilde depolanabilmesi için Azure Haritalar REST API'lerine erişmek için gizli istemci uygulamaları yaklaşımını kullanmanızı öneririz.

Tür: apiKey
İçinde: 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ğı 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

Search detail address 15127 NE 24th Street, Redmond, WA

Search detail address 15127 NE 24th Street, Redmond, WA by addressLine

Search detail address 15127 NE 24th Street, Redmond, WA by query

Search landmark Empire State Building by query

Search detail address 15127 NE 24th Street, Redmond, WA

Örnek isteği

HTTP

GET https://atlas.microsoft.com/geocode?api-version=2026-01-01&addressLine=15127 NE 24th Street&adminDistrict=WA&locality=Redmond

Örnek yanıt

Durum kodu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "WA"
            },
            {
              "shortName": "King County"
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
          "streetName": "NE 24th St",
          "streetNumber": "15127",
          "locality": "Redmond",
          "postalCode": "98052",
          "addressLine": "15127 NE 24th St"
        },
        "type": "Address",
        "confidence": "High",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.138681,
                47.630358
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          },
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.1386787,
                47.6302179
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.138681,
          47.630358
        ]
      },
      "bbox": [
        -122.14632282407,
        47.626495282429325,
        -122.13103917593001,
        47.63422071757068
      ]
    }
  ]
}

Search detail address 15127 NE 24th Street, Redmond, WA by addressLine

Örnek isteği

HTTP

GET https://atlas.microsoft.com/geocode?api-version=2026-01-01&addressLine=15127 NE 24th Street Redmond WA&countryRegion=US

Örnek yanıt

Durum kodu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "WA"
            },
            {
              "shortName": "King County"
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
          "streetName": "NE 24th St",
          "streetNumber": "15127",
          "locality": "Redmond",
          "postalCode": "98052",
          "addressLine": "15127 NE 24th St"
        },
        "type": "Address",
        "confidence": "Medium",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.138681,
                47.630358
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          },
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.1386787,
                47.6302179
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.138681,
          47.630358
        ]
      },
      "bbox": [
        -122.14632282407,
        47.626495282429325,
        -122.13103917593001,
        47.63422071757068
      ]
    }
  ]
}

Search detail address 15127 NE 24th Street, Redmond, WA by query

Örnek isteği

HTTP

GET https://atlas.microsoft.com/geocode?api-version=2026-01-01&query=15127 NE 24th Street Redmond WA

Örnek yanıt

Durum kodu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "WA"
            },
            {
              "shortName": "King County"
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
          "streetName": "NE 24th St",
          "streetNumber": "15127",
          "locality": "Redmond",
          "postalCode": "98052",
          "addressLine": "15127 NE 24th St"
        },
        "type": "Address",
        "confidence": "High",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.138681,
                47.630358
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          },
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.1386787,
                47.6302179
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.138681,
          47.630358
        ]
      },
      "bbox": [
        -122.14632282407,
        47.626495282429325,
        -122.13103917593001,
        47.63422071757068
      ]
    }
  ]
}

Search landmark Empire State Building by query

Örnek isteği

HTTP

GET https://atlas.microsoft.com/geocode?api-version=2026-01-01&query=empire state building

Örnek yanıt

Durum kodu:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "NY"
            }
          ],
          "formattedAddress": "Empire State Building, NY",
          "locality": "New York"
        },
        "type": "PointOfInterest",
        "confidence": "High",
        "matchCodes": [
          "Ambiguous"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -73.98580932617188,
                40.748435974121094
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -73.98580932617188,
          40.748435974121094
        ]
      },
      "bbox": [
        -73.98590850830078,
        40.74833679199219,
        -73.98571014404297,
        40.74853515625
      ]
    },
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "NY"
            },
            {
              "shortName": "New York County"
            }
          ],
          "formattedAddress": "Empire State Building, NY",
          "locality": "Manhattan"
        },
        "type": "LandmarkBuilding",
        "confidence": "High",
        "matchCodes": [
          "Ambiguous"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -73.98500061035156,
                40.74815368652344
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -73.98500061035156,
          40.74815368652344
        ]
      },
      "bbox": [
        -73.98710632324219,
        40.747314453125,
        -73.98412322998047,
        40.74958038330078
      ]
    }
  ]
}

Tanımlar

Name	Description
Address	Sonucun adresi
AddressAdminDistrictsItem	Bir adresin ülke veya bölgedeki alt bölüm adı.
AddressCountryRegion	Adı ve ISO koduyla birlikte ülke veya bölge.
Azure.Core.Foundations.Error	Hata nesnesi.
Azure.Core.Foundations.ErrorResponse	Hata ayrıntılarını içeren bir yanıt.
Azure.Core.Foundations.InnerError	Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.
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 ayrıntılı 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.
FeatureCollectionEnum	`GeoJSON` türünü belirtir. Desteklenen tek nesne türü `FeatureCollection`. Daha fazla bilgi için bkz. rfc 7946.
FeaturesItem	Bir özellik nesnesi.
FeaturesItemProperties	Özelliğin özellikleri.
FeatureTypeEnum	Bir özelliğin türü Özellik olmalıdır.
GeocodePointsItem	Bir coğrafi kod noktası.
GeocodingResponse	Bu nesne başarılı bir Coğrafi Kodlama çağrısından döndürülür
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.
GeoJsonPoint	Geçerli bir `GeoJSON Point` geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Intersection	Sonucun adresi.
MatchCodesEnum	Eşleşme kodunu temsil eden bir enum.
UsageTypeEnum	Kullanım türünü temsil eden bir enum.

Address

Nesne

Sonucun adresi

Name	Tür	Description
addressLine	string	Sokak adını ve numarasını içeren AddressLine
adminDistricts	AddressAdminDistrictsItem[]	Bir adresin ülke veya bölgedeki alt bölüm adı. Bu öğe genellikle ilk 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	AddressCountryRegion	Adı ve ISO koduyla birlikte ülke veya bölge.
formattedAddress	string	Biçimlendirilmiş adres özelliği
intersection	Intersection	Sonucun adresi.
locality	string	Bölge özelliği
neighborhood	string	Mahalle mülkü
postalCode	string	Posta kodu özelliği
streetName	string	formattedAddress'teki sokağın adı
streetNumber	string	Sokaktaki numara (varsa) formattedAddress

AddressAdminDistrictsItem

Nesne

Bir adresin ülke veya bölgedeki alt bölüm adı.

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

AddressCountryRegion

Nesne

Adı ve ISO koduyla birlikte ülke veya bölge.

Name	Tür	Description
ISO	string	Iso ülke/bölge
name	string	ülke/bölge adı

Azure.Core.Foundations.Error

Nesne

Hata nesnesi.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	Azure.Core.Foundations.Error[]	Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı.
innererror	Azure.Core.Foundations.InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
target	string	Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Nesne

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	Azure.Core.Foundations.Error	Hata nesnesi.

Azure.Core.Foundations.InnerError

Nesne

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
innererror	Azure.Core.Foundations.InnerError	İç hata.

CalculationMethodEnum

Numaralandırma

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

Değer	Description
Interpolation	Coğrafi kod noktası, enterpolasyon kullanılarak bir yoldaki bir noktayla eşleştirildi.
InterpolationOffset	Coğrafi kod noktası, noktayı caddenin kenarına kaydırmak için ek bir ofset ile enterpolasyon kullanılarak bir yoldaki bir noktayla eşleştirildi.
Parcel	Coğrafi kod noktası, bir parselin merkeziyle eşleştirildi.
Rooftop	Coğrafi kod noktası, bir binanın çatısıyla eşleştirildi.

ConfidenceEnum

Numaralandırma

Coğrafi olarak kodlanmış konum sonucunun eşleşmesi güven düzeyi. Eşleşme hakkında daha ayrıntılı 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.

Değer Description

High

Değer	Description
High	Güvenilirlik olarak `High`ayarlanırsa, bir veya daha fazla güçlü eşleşme bulundu. Çoklu `High` güvenilirlik eşleşmeleri, uygun olduğunda önem derecesine göre sıralanır. Örneğin, yer işaretlerinin önemi vardır, ancak adreslerin önemi yoktur. Bir istek bir konum veya görünüm içeriyorsa sıralama uygun şekilde değişebilir. Örneğin, "Paris" için bir konum sorgusu, hem "Paris, Fransa" hem de `High` "Paris, TX" değerlerini güvenle döndürür. "Paris, Fransa", bir kullanıcı konumu kullanıcının Paris, Teksas'ta veya çok yakınında olduğunu göstermedikçe veya harita görünümü kullanıcının o bölgede arama yaptığını göstermedikçe, önem nedeniyle her zaman ilk sırada yer alır.
Medium	Bazı durumlarda, iade edilen eşleşme, istekte sağlanan bilgilerle aynı seviyede 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 hizmetinin posta kodunun verilerle eşleştiğine dair bir güveni varsa, güven olarak `Medium` ayarlanır ve eşleşme kodu, tüm bilgilerle eşleşemediğini ve hiyerarşide arama yapması gerektiğini belirtmek için olarak `UpHierarchy` ayarlanır. Sorgudaki konum bilgileri belirsizse ve konumları sıralamak için ek bilgi yoksa (kullanıcı konumu veya konumun göreli önemi gibi), güvenilirlik olarak `Medium`ayarlanır. Örneğin, "148th Ave, Bellevue" için bir konum sorgusu, "148th Ave SE" ve "148th Ave NE" ifadelerinin her ikisini de `Medium` güvenle döndürebilir. Sorgudaki konum bilgileri belirli bir konumu coğrafi olarak 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 bina numarası için bir eşleşme bulunamazsa, Roadblock varlık türüne sahip coğrafi kod sonucu döndürülebilir.
Low	Low

Güvenilirlik olarak Highayarlanırsa, bir veya daha fazla güçlü eşleşme bulundu. Çoklu High güvenilirlik eşleşmeleri, uygun olduğunda önem derecesine göre sıralanır. Örneğin, yer işaretlerinin önemi vardır, ancak adreslerin önemi yoktur.

Bir istek bir konum veya görünüm içeriyorsa sıralama uygun şekilde değişebilir. Örneğin, "Paris" için bir konum sorgusu, hem "Paris, Fransa" hem de High "Paris, TX" değerlerini güvenle döndürür. "Paris, Fransa", bir kullanıcı konumu kullanıcının Paris, Teksas'ta veya çok yakınında olduğunu göstermedikçe veya harita görünümü kullanıcının o bölgede arama yaptığını göstermedikçe, önem nedeniyle her zaman ilk sırada yer alır.

Medium

Bazı durumlarda, iade edilen eşleşme, istekte sağlanan bilgilerle aynı seviyede 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 hizmetinin posta kodunun verilerle eşleştiğine dair bir güveni varsa, güven olarak Medium ayarlanır ve eşleşme kodu, tüm bilgilerle eşleşemediğini ve hiyerarşide arama yapması gerektiğini belirtmek için olarak UpHierarchy ayarlanır.

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

Sorgudaki konum bilgileri belirli bir konumu coğrafi olarak 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 bina numarası için bir eşleşme bulunamazsa, Roadblock varlık türüne sahip coğrafi kod sonucu döndürülebilir.

Low

FeatureCollectionEnum

Numaralandırma

GeoJSON türünü belirtir. Desteklenen tek nesne türü FeatureCollection. Daha fazla bilgi için bkz. rfc 7946.

Değer	Description
FeatureCollection	`GeoJSON` `FeatureCollection` nesne türünü belirtir.

FeaturesItem

Nesne

Bir özellik nesnesi.

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

FeaturesItemProperties

Nesne

Özelliğin özellikleri.

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 ayrıntılı 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	GeocodePointsItem[]	Hesaplanma şekli ve önerilen kullanımları bakımından farklılık gösteren bir coğrafi kod noktaları koleksiyonu.
matchCodes	MatchCodesEnum[]	Yanıttaki her konumun coğrafi kodlama düzeyini temsil eden bir veya daha fazla eşleşme kodu değeri. Örneğin, `Good` ve `Ambiguous` eşleşme kodlarıyla coğrafi olarak kodlanmış bir konum, konum bilgileri için birden fazla coğrafi kod konumu bulunduğu ve coğrafi kod hizmetinin eşleşme bulmak için hiyerarşiyi aramadığı anlamına gelir. Benzer şekilde, `Ambiguous` ve `UpHierarchy` eşleşme kodlarıyla 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 yukarı hiyerarşiyi araması ve bu düzeyde birden çok eşleşme bulması gerekir. bir `Ambiguous` ve `UpHierarchy` sonucunun bir örneği, tam adres bilgileri sağladığınız, ancak coğrafi kod hizmetinin sokak adresi için bir eşleşme bulamaması ve bunun yerine birden fazla RoadBlock değeri için bilgi döndürmesidir. Olası değerler: `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, bir dizi olası eşleşmeden 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 bir 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 eşleşme bulunamazsa, RoadBlock varlık türüne sahip `UpHierarchy` eşleşme kodu döndürülebilir.
type	string	Bunlardan biri: * Adres * Yol Blokajı * Yol Kavşağı * Mahalle * Nüfuslu Yer * Posta Kodu 1 * Yönetici Bölüm1 * Yönetici Bölüm2 * ÜlkeBölge

FeatureTypeEnum

Numaralandırma

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

Değer	Description
Feature	`GeoJSON` Özelliği nesne türünü belirtir.

GeocodePointsItem

Nesne

Bir coğrafi kod noktası.

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

GeocodingResponse

Nesne

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

Name	Tür	Description
features	FeaturesItem[]	Sorgudan geri dönen bir dizi özellik.
nextLink	string	, döndürülen özelliklerin sonraki sayfasının bağlantısıdır. Bu son sayfaysa, bu alan yok.
type	FeatureCollectionEnum	`GeoJSON` türünü belirtir. Desteklenen tek nesne türü `FeatureCollection`. Daha fazla bilgi için bkz. rfc 7946.

GeoJsonObjectType

Numaralandırma

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.

Değer	Description
Point	geometriyi `GeoJSON Point`.
MultiPoint	geometriyi `GeoJSON MultiPoint`.
LineString	geometriyi `GeoJSON LineString`.
MultiLineString	geometriyi `GeoJSON MultiLineString`.
Polygon	geometriyi `GeoJSON Polygon`.
MultiPolygon	geometriyi `GeoJSON MultiPolygon`.
GeometryCollection	geometriyi `GeoJSON GeometryCollection`.
Feature	`GeoJSON Feature` nesne.
FeatureCollection	`GeoJSON FeatureCollection` nesne.

GeoJsonPoint

Nesne

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

Name	Tür	Description
bbox	number[] (double)	Sınırlayıcı kutu. Projeksiyon kullanıldı - EPSG:3857. Ayrıntılar için lütfen RFC 7946 bakın.
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.

Intersection

Nesne

Sonucun adresi.

Name	Tür	Description
baseStreet	string	Konum için birincil sokak.
displayName	string	Kesişimin tam adı.
intersectionType	string	Kesişim türü.
secondaryStreet1	string	kesişen ilk sokak.
secondaryStreet2	string	Eğer varsa, ikinci kesişen sokak.

MatchCodesEnum

Numaralandırma

Eşleşme kodunu temsil eden bir enum.

Değer	Description
Good	İyi
Ambiguous	Belirsiz
UpHierarchy	Üst Hiyerarşi

UsageTypeEnum

Numaralandırma

Kullanım türünü temsil eden bir enum.

Değer	Description
Display	Ekran
Route	Güzergâh