Azure Haritalar Arama hizmeti için en iyi yöntemler
Azure Haritalar Arama hizmeti, geliştiricilerin adreslerde, yerlerde, işletme listelerinde ada veya kategoriye ve diğer coğrafi bilgilere göre arama yapmalarına yardımcı olacak çeşitli özellikler sunan API'yi içerir. Örneğin, Arama Belirsiz özelliği kullanıcıların bir adres veya İlgi Çekici Nokta (POI) araması yapmasına olanak tanır.
Bu makalede, Azure Haritalar Arama hizmeti'dan veri çağırırken ses uygulamalarının nasıl uygulanacağı açıklanmaktadır. Nasıl yapılacağını öğrenin:
- İlgili eşleşmeleri döndürmek için sorgu oluşturma
- Arama sonuçlarını sınırlama
- Sonuç türleri arasındaki farkları öğrenin
- Adres arama yanıt yapısını okuma
Önkoşullar
Bu makalede REST çağrıları oluşturmak için Postman uygulaması kullanılır, ancak herhangi bir API geliştirme ortamını seçebilirsiniz.
Adresleri coğrafi kodlamaya yönelik en iyi yöntemler
Azure Haritalar Arama hizmeti kullanarak tam veya kısmi bir adres aradığınızda, API arama sorgunuzdan anahtar sözcükleri okur. Ardından adresin boylam ve enlem koordinatlarını döndürür. Bu işleme coğrafi kodlama adı verilir.
Bir ülkede/bölgede coğrafi kodlama özelliği, yol verilerinin kullanılabilirliğine ve coğrafi kodlama hizmetinin duyarlığına bağlıdır. Ülkeye veya bölgeye göre Azure Haritalar coğrafi kodlama özellikleri hakkında daha fazla bilgi için bkz. Coğrafi kodlama kapsamı.
Arama sonuçlarını sınırlama
Azure Haritalar Arama API'si, arama sonuçlarını uygun şekilde sınırlamanıza yardımcı olabilir. Kullanıcılarınıza ilgili verileri görüntüleyebilmek için sonuçları sınırlarsınız.
Not
Arama API'leri, bu makalede anlatılanlardan daha fazla parametreyi destekler.
Coğrafi olarak belirlenmiş arama sonuçları
Kullanıcınızın ilgili alanına geobias sonuçları eklemek için her zaman mümkün olduğunca çok konum ayrıntısı ekleyin. Bazı giriş türleri belirterek arama sonuçlarını kısıtlamak isteyebilirsiniz:
parametresini
countrySetayarlayın. Örneğin olarak ayarlayabilirsinizUS,FR. Api varsayılan olarak tüm dünyada arama yaparak gereksiz sonuçlar döndürebilir. Sorgunuzda parametre yoksacountrySet, arama yanlış sonuçlar döndürebilir. Örneğin, Bellevue adlı bir şehir için yapılan bir arama, her iki ülke/bölge de Bellevue adlı bir şehir içerdiğinden ABD ve Fransa'dan sonuçlar döndürür.sınırlayıcı kutuyu ayarlamak için ve
topleftparametrelerini kullanabilirsinizbtmRight. Bu parametreler, aramayı haritadaki belirli bir alanla kısıtlar.Sonuçların ilgi alanını etkilemek için ve
lonkoordinat parametrelerini tanımlayınlat.radiusArama alanının yarıçapını ayarlamak için parametresini kullanın.
Benzer arama parametreleri
Arama sorgusu için kullanıcı girişlerinizi bilmediğinizde Arama Benzerini kullanmanızı öneririz. Örneğin, kullanıcının girişi bir adres veya alışveriş merkezi gibi bir İlgi Noktası (POI) türü olabilir. API, POI arama ve coğrafi kodlamayı kurallı tek satırlı aramada birleştirir:
ve
maxFuzzyLevelparametreleri,minFuzzyLevelsorgu parametreleri kullanıcının istediği bilgilerle tam olarak eşleşmediğinde bile ilgili eşleşmeleri döndürmeye yardımcı olur. Performansı en üst düzeye çıkarmak ve olağan dışı sonuçları azaltmak için arama sorgularını varsayılan veminFuzzyLevel=1maxFuzzyLevel=2olarak ayarlayın.Örneğin,
maxFuzzyLevelparametre 2 olarak ayarlandığında, arama terimi restrant restaurant ile eşleştirilir. Gerektiğinde varsayılan benzer düzeyleri geçersiz kılabilirsiniz.Sonuç türlerinin
idxSettam kümesini önceliklendirmek için parametresini kullanın. Tam bir sonuç kümesinin önceliğini belirlemek için virgülle ayrılmış dizin listesi gönderebilirsiniz. Listenizde, madde siparişi önemli değildir. Azure Haritalar aşağıdaki dizinleri destekler:Addr- Adres aralıkları: Caddenin başından ve sonundan ilişkilendirilmiş adres noktaları. Bu noktalar adres aralıkları olarak temsil edilir.Geo- Coğrafyalar: arazinin Yönetici istratif bölümleri. Coğrafya, örneğin bir ülke/bölge, eyalet veya şehir olabilir.PAD- Nokta adresleri: Sokak adı ve numarası içeren adresler. Nokta adresleri bir dizinde bulunabilir. Örnek olarak Soquel Dr 2501 verilmiştir. Nokta adresi, adresler için kullanılabilir en yüksek doğruluk düzeyini sağlar.POI- İlgi çekici noktalar: Haritada dikkat edilmesi gereken veya ilgi çekici olabilecek noktalar. Arama Adresi , İÇ'leri döndürmez.Str- Sokaklar: Haritada sokaklar.XStr- Çapraz sokaklar veya kavşaklar: Kavşaklar veya iki caddenin kesiştiği yerler.
Kullanım örnekleri
idxSet=POI- Yalnızca POI'leri arayın.idxSet=PAD,Addr- Yalnızca arama adresleri.PADnokta adresini veAddradres aralığını gösterir.
Coğrafi varlık türü için ters coğrafi kod ve filtre uygulama
Arama Adresi TersIni kullanarak ters coğrafi kod araması yaptığınızda, hizmet yönetim alanları için çokgenler döndürebilir. Örneğin, bir şehir için bölge çokgenini getirmek isteyebilirsiniz. Aramayı belirli coğrafya varlık türlerine daraltmak için isteklerinize parametresini entityType ekleyin.
Sonuçta elde edilen yanıt, coğrafya kimliğini ve eşleşen varlık türünü içerir. Birden fazla varlık sağlarsanız uç nokta kullanılabilir en küçük varlığı döndürür. Coğrafyanın geometrisini Search Polygon hizmeti aracılığıyla almak için döndürülen geometri kimliğini kullanabilirsiniz.
Örnek isteği
https://atlas.microsoft.com/search/address/reverse/json?api-version=1.0&subscription-key={Your-Azure-Maps-Subscription-key}&query=47.6394532,-122.1304551&language=en-US&entityType=Municipality
Response
{
"summary": {
"queryTime": 14,
"numResults": 1
},
"addresses": [
{
"address": {
"routeNumbers": [],
"countryCode": "US",
"countrySubdivision": "WA",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"municipality": "Redmond",
"country": "United States",
"countryCodeISO3": "USA",
"countrySubdivisionName": "Washington"
},
"position": "47.639454,-122.130455",
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-0000596ae571"
}
},
"entityType": "Municipality"
}
]
}
Sonuç dilini ayarlama
Döndürülen arama sonuçlarının language dilini ayarlamak için parametresini kullanın. İstek dili ayarlamazsa, varsayılan olarak Arama hizmeti ülke veya bölgedeki en yaygın dili kullanır. Belirtilen dilde kullanılabilir veri olmadığında varsayılan dil kullanılır.
Daha fazla bilgi için bkz. desteklenen Azure Haritalar diller.
Tahmin modunu kullanma (otomatik öneriler)
Kısmi sorgular için daha fazla eşleşme bulmak için parametresini typeahead olarak trueayarlayın. Bu sorgu kısmi giriş olarak yorumlanır ve arama tahmin moduna girer. parametresini typeaheadtrueolarak ayarlamazsanız, hizmet tüm ilgili bilgilerin geçirildiğini varsayar.
Aşağıdaki örnek sorguda, Arama Adresi hizmeti Microso için sorgulanır. typeahead Burada parametresi olarak trueayarlanır. Yanıt, arama hizmetinin sorguyu kısmi sorgu olarak yorumladığını gösterir. Yanıt, otomatik olarak önerilen sorgunun sonuçlarını içerir.
Örnek sorgu
https://atlas.microsoft.com/search/address/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&typeahead=true&countrySet=US&lat=47.6370891183&lon=-122.123736172&query=Microsoft
Response
{
"summary": {
"query": "microsoft",
"queryType": "NON_NEAR",
"queryTime": 18,
"numResults": 7,
"offset": 0,
"totalResults": 7,
"fuzzyLevel": 1,
"geoBias": {
"lat": 47.6370891183,
"lon": -122.123736172
}
},
"results": [
{
"type": "Street",
"id": "US/STR/p0/9438784",
"score": 2.594099998474121,
"dist": 314.0590106663596,
"address": {
"streetName": "Microsoft Way",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
},
"position": {
"lat": 47.63988,
"lon": -122.12438
},
"viewport": {
"topLeftPoint": {
"lat": 47.64223,
"lon": -122.1256,
"valid": true
},
"btmRightPoint": {
"lat": 47.63748,
"lon": -122.12309,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/1756074",
"score": 2.592679977416992,
"dist": 876.0272035824189,
"address": {
"streetName": "Microsoft Road",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98052",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Microsoft Road, Redmond, WA 98052"
},
"position": {
"lat": 47.64032,
"lon": -122.1344
},
"viewport": {
"topLeftPoint": {
"lat": 47.64253,
"lon": -122.13535,
"valid": true
},
"btmRightPoint": {
"lat": 47.63816,
"lon": -122.13305,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/1470668",
"score": 2.5290400981903076,
"dist": 2735.4883918101486,
"address": {
"streetName": "Microsoft West Campus Road",
"municipalitySubdivision": "Redmond",
"municipality": "Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98007",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Microsoft West Campus Road, Bellevue, WA 98007"
},
"position": {
"lat": 47.65784,
"lon": -122.14335
},
"viewport": {
"topLeftPoint": {
"lat": 47.65785,
"lon": -122.14335,
"valid": true
},
"btmRightPoint": {
"lat": 47.65784,
"lon": -122.14325,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/12812615",
"score": 2.527509927749634,
"dist": 2870.9579016916873,
"address": {
"streetName": "Microsoft West Campus Road",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98052",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Microsoft West Campus Road, Redmond, WA 98052"
},
"position": {
"lat": 47.66034,
"lon": -122.1404
},
"viewport": {
"topLeftPoint": {
"lat": 47.66039,
"lon": -122.14325,
"valid": true
},
"btmRightPoint": {
"lat": 47.65778,
"lon": -122.13749,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/197588",
"score": 2.4630401134490967,
"dist": 878.1404663812472,
"address": {
"streetName": "157th Avenue Northeast",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98052",
"extendedPostalCode": "980525344, 980525398, 980525399",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "157th Avenue Northeast, Redmond, WA 98052"
},
"position": {
"lat": 47.64351,
"lon": -122.13056
},
"viewport": {
"topLeftPoint": {
"lat": 47.64473,
"lon": -122.13058,
"valid": true
},
"btmRightPoint": {
"lat": 47.6425,
"lon": -122.13016,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/3033991",
"score": 2.0754499435424805,
"dist": 3655467.8844475765,
"address": {
"streetName": "Microsoft Way",
"municipalitySubdivision": "Yorkmount, Charlotte",
},
"position": {
"lat": 35.14267,
"lon": -80.91824
},
"viewport": {
"topLeftPoint": {
"lat": 35.14287,
"lon": -80.91839,
"valid": true
},
"btmRightPoint": {
"lat": 35.14267,
"lon": -80.91814,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/8395877",
"score": 2.0754499435424805,
"dist": 3655437.0037482483,
"address": {
"streetName": "Microsoft Way",
"municipalitySubdivision": "Charlotte",
"municipality": "Charlotte",
"countrySecondarySubdivision": "Mecklenburg",
"countryTertiarySubdivision": "Township 1 Charlotte",
"countrySubdivision": "NC",
"countrySubdivisionName": "North Carolina",
"postalCode": "28273",
"extendedPostalCode": "282738105, 282738106, 282738108, 2827382, 282738200",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Microsoft Way, Charlotte, NC 28273"
},
"position": {
"lat": 35.14134,
"lon": -80.9198
},
"viewport": {
"topLeftPoint": {
"lat": 35.14274,
"lon": -80.92159,
"valid": true
},
"btmRightPoint": {
"lat": 35.14002,
"lon": -80.91824,
"valid": true
}
}
}
]
}
Özel karakterleri işlemek için URI kodlama
Çapraz sokak adreslerini bulmak için URI'yi adresteki özel karakterleri işleyecek şekilde kodlamanız gerekir. Şu adres örneğini düşünün: 1st Avenue & Union Street, Seattle. Burada, isteği göndermeden önce ve karakterini (&) kodlayın.
Karakter verilerini bir URI'de kodlamanızı öneririz. URI'de, yüzde işareti (%) ve karakterlerin UTF-8 koduna karşılık gelen iki karakterli onaltılık değer kullanarak tüm karakterleri kodlarsınız.
Kullanım örnekleri
Şu adresle başlayın:
query=1st Avenue & E 111th St, New York
Adresi kodla:
query=1st%20Avenue%20%26%20E%20111th%20St%2C%20New%20York
Aşağıdaki yöntemleri kullanabilirsiniz.
JavaScript veya TypeScript:
encodeURIComponent(query)
C# veya Visual Basic:
Uri.EscapeDataString(query)
Java:
URLEncoder.encode(query, "UTF-8")
Python:
import urllib.parse
urllib.parse.quote(query)
C++:
#include <curl/curl.h>
curl_easy_escape(query)
PHP:
urlencode(query)
Ruby:
CGI::escape(query)
Swift:
query.stringByAddingPercentEncodingWithAllowedCharacters(.URLHostAllowedCharacterSet())
Git:
import ("net/url")
url.QueryEscape(query)
POI araması için en iyi yöntemler
PoI aramasında, POI sonuçlarını ada göre isteyebilirsiniz. Örneğin, bir işletmeyi ada göre arayabilirsiniz.
Uygulamanızın kapsama ihtiyacı olan ülkeleri/bölgeleri belirtmek için parametresini kullanmanızı countrySet kesinlikle öneririz. Varsayılan davranış, tüm dünyada arama yapmaktır. Bu geniş arama gereksiz sonuçlar döndürebilir ve arama uzun sürebilir.
Marka araması
Sonuçların ve yanıttaki bilgilerin ilgi düzeyini artırmak için POI arama yanıtı marka bilgilerini içerir. Yanıtı ayrıştırmak için bu bilgileri daha fazla kullanabilirsiniz.
bir istekte, marka adlarının virgülle ayrılmış bir listesini gönderebilirsiniz. parametresini ayarlayarak sonuçları belirli markalara kısıtlamak brandSet için listeyi kullanın. Listenizde madde siparişi önemli değildir. Birden çok marka listesi sağladığınızda, döndürülen sonuçlar listelerinizin en az birine ait olmalıdır.
Marka aramasını keşfetmek için poi kategorisi arama isteğinde bulunalım. Aşağıdaki örnekte, Redmond, Washington'daki Microsoft kampüsü yakınlarındaki benzin istasyonlarına bakacağız. Yanıt, döndürülen her poi için marka bilgilerini gösterir.
Örnek sorgu
https://atlas.microsoft.com/search/poi/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&query=gas%20station&limit=3&lat=47.6413362&lon=-122.1327968
Response
{
"summary": {
"query": "gas station",
"queryType": "NON_NEAR",
"queryTime": 276,
"numResults": 3,
"offset": 0,
"totalResults": 762680,
"fuzzyLevel": 1,
"geoBias": {
"lat": 47.6413362,
"lon": -122.1327968
}
},
"results": [
{
"type": "POI",
"id": "US/POI/p0/8831765",
"score": 5.6631999015808105,
"dist": 1037.0280221303253,
"info": "search:ta:840531000004190-US",
"poi": {
"name": "Chevron",
"phone": "+(1)-(425)-6532200",
"brands": [
{
"name": "Chevron"
}
],
"categorySet": [
{
"id": 7311
}
],
"url": "www.chevron.com",
"categories": [
"petrol station"
],
"classifications": [
{
"code": "PETROL_STATION",
"names": [
{
"nameLocale": "en-US",
"name": "petrol station"
}
]
}
]
},
"address": {
"streetNumber": "2444",
"streetName": "Bel Red Rd",
"municipalitySubdivision": "Northeast Bellevue, Bellevue",
},
"position": {
"lat": 47.63201,
"lon": -122.13281
},
"viewport": {
"topLeftPoint": {
"lat": 47.63291,
"lon": -122.13414,
"valid": true
},
"btmRightPoint": {
"lat": 47.63111,
"lon": -122.13148,
"valid": true
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.63222,
"lon": -122.13312,
"valid": true
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/8831752",
"score": 5.662710189819336,
"dist": 1330.1278248163273,
"info": "search:ta:840539001100326-US",
"poi": {
"name": "76",
"phone": "+(1)-(425)-7472126",
"brands": [
{
"name": "76"
}
],
"categorySet": [
{
"id": 7311
}
],
"url": "www.76.com",
"categories": [
"petrol station"
],
"classifications": [
{
"code": "PETROL_STATION",
"names": [
{
"nameLocale": "en-US",
"name": "petrol station"
}
]
}
]
},
"address": {
"streetNumber": "2421",
"streetName": "148Th Ave Ne",
"municipalitySubdivision": "Redmond, Bridle Trails, Bellevue",
"municipality": "Redmond, Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98007",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "2421 148Th Ave Ne, Bellevue, WA 98007",
"localName": "Bellevue"
},
"position": {
"lat": 47.63187,
"lon": -122.14365
},
"viewport": {
"topLeftPoint": {
"lat": 47.63277,
"lon": -122.14498,
"valid": true
},
"btmRightPoint": {
"lat": 47.63097,
"lon": -122.14232,
"valid": true
}
},
"entryPoints": [
{
"type": "minor",
"position": {
"lat": 47.63187,
"lon": -122.14374,
"valid": true
}
},
{
"type": "main",
"position": {
"lat": 47.63186,
"lon": -122.14313,
"valid": true
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/8831764",
"score": 5.662449836730957,
"dist": 1458.645407416307,
"info": "search:ta:840539000488527-US",
"poi": {
"name": "BROWN BEAR CAR WASH",
"phone": "+(1)-(425)-6442868",
"brands": [
{
"name": "Texaco"
}
],
"categorySet": [
{
"id": 7311
}
],
"url": "www.texaco.com/",
"categories": [
"petrol station"
],
"classifications": [
{
"code": "PETROL_STATION",
"names": [
{
"nameLocale": "en-US",
"name": "petrol station"
}
]
}
]
},
"address": {
"streetNumber": "15248",
"streetName": "Bel Red Rd",
"municipalitySubdivision": "Redmond",
},
"position": {
"lat": 47.62843,
"lon": -122.13628
},
"viewport": {
"topLeftPoint": {
"lat": 47.62933,
"lon": -122.13761,
"valid": true
},
"btmRightPoint": {
"lat": 47.62753,
"lon": -122.13495,
"valid": true
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.62827,
"lon": -122.13628,
"valid": true
}
}
]
}
]
}
Havaalanı araması
Arama POI API'sini kullanarak, resmi kodlarını kullanarak havalimanlarını arayabilirsiniz. Örneğin, SEA kullanarak Seattle-Tacoma Uluslararası Havaalanı'nı bulabilirsiniz:
https://atlas.microsoft.com/search/poi/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&query=SEA
Yakındaki arama
Belirli bir konumla ilgili POI sonuçlarını almak için Yakını Ara'yı kullanmayı deneyebilirsiniz. Uç nokta yalnızca POI sonuçlarını döndürür. Arama sorgusu parametresinde yer almaz.
Sonuçları sınırlamak için yarıçapı ayarlamanızı öneririz.
Yanıtları anlama
Şimdi Azure Haritalar Arama hizmeti adres arama isteğinde bulunarak Seattle'da bir adres bulalım. Aşağıdaki istek URL'sinde, ABD'deki adresi aramak için parametresini US olarak ayarladıkcountrySet.
Örnek sorgu
https://atlas.microsoft.com/search/address/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1&query=400%20Broad%20Street%2C%20Seattle%2C%20WA&countrySet=US
Desteklenen sonuç türleri
Nokta Adresi: Açık adı ve numarası olan belirli bir adrese sahip olan haritadaki noktalar. Nokta Adresi, adresler için en yüksek doğruluk düzeyini sağlar.
Adres Aralığı: Caddenin başından ve sonundan ilişkilendirilmiş adres noktaları aralığı.
Coğrafya: Ülke/bölge, eyalet veya şehir gibi bir arazinin yönetim bölmelerini temsil eden harita üzerindeki alanlar.
POI: Dikkat edilmesi gereken ve ilgi çekici olabilecek bir haritadaki noktalar.
Sokak: Haritada sokaklar. Adresler, adresi içeren caddenin enlem ve boylam koordinatlarına çözümlenir. Ev numarası işlenmeyebilir.
Çapraz: Kesişimler. Çapraz sokaklar, iki caddenin kesiştiği kavşakları temsil eder.
Response
Şimdi yanıt yapısına bakalım. Aşağıdaki yanıtta, sonuç nesnelerinin türleri farklıdır. Dikkatli bakarsanız üç tür sonuç nesnesi görürsünüz:
- Nokta Adresi
- Sokak
- Çapraz Cadde
Adres aramasının İÇ'leri döndürmediğini fark edin.
Her yanıt nesnesinin Score parametresi, eşleşen puanın aynı yanıttaki diğer nesnelerin puanlarıyla ilişkisini gösterir. Yanıt nesnesi parametreleri hakkında daha fazla bilgi için bkz . Arama Adresi Alma.
{
"summary": {
"query": "400 broad street seattle wa",
"queryType": "NON_NEAR",
"queryTime": 146,
"numResults": 6,
"offset": 0,
"totalResults": 7,
"fuzzyLevel": 1
},
"results": [
{
"type": "Point Address",
"id": "US/PAD/p0/28725082",
"score": 9.893799781799316,
"address": {
"streetNumber": "400",
"streetName": "Broad Street",
},
"position": {
"lat": 47.62039,
"lon": -122.34928
},
"viewport": {
"topLeftPoint": {
"lat": 47.62129,
"lon": -122.35061,
"valid": true
},
"btmRightPoint": {
"lat": 47.61949,
"lon": -122.34795,
"valid": true
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.61982,
"lon": -122.34886,
"valid": true
}
}
]
},
{
"type": "Street",
"id": "US/STR/p0/6700384",
"score": 8.129190444946289,
"address": {
"streetName": "Broad Street",
},
"position": {
"lat": 47.61724,
"lon": -122.35207
},
"viewport": {
"topLeftPoint": {
"lat": 47.61825,
"lon": -122.35336,
"valid": true
},
"btmRightPoint": {
"lat": 47.61626,
"lon": -122.35078,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/9701953",
"score": 8.129190444946289,
"address": {
"streetName": "Broad Street",
},
"position": {
"lat": 47.61965,
"lon": -122.349
},
"viewport": {
"topLeftPoint": {
"lat": 47.62066,
"lon": -122.35041,
"valid": true
},
"btmRightPoint": {
"lat": 47.61857,
"lon": -122.34761,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/11721297",
"score": 8.129190444946289,
"address": {
"streetName": "Broad Street",
"municipalitySubdivision": "Seattle, Downtown Seattle, Denny Regrade, Belltown",
"municipality": "Seattle",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98121",
"extendedPostalCode": "981211237",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Broad Street, Seattle, WA 98121"
},
"position": {
"lat": 47.61825,
"lon": -122.35078
},
"viewport": {
"topLeftPoint": {
"lat": 47.61857,
"lon": -122.35078,
"valid": true
},
"btmRightPoint": {
"lat": 47.61825,
"lon": -122.35041,
"valid": true
}
}
},
{
"type": "Cross Street",
"id": "US/XSTR/p1/232144",
"score": 6.754479885101318,
"address": {
"streetName": "Broad Street & Valley Street",
"municipalitySubdivision": "South Lake Union, Seattle",
},
"position": {
"lat": 47.62545,
"lon": -122.33974
},
"viewport": {
"topLeftPoint": {
"lat": 47.62635,
"lon": -122.34107,
"valid": true
},
"btmRightPoint": {
"lat": 47.62455,
"lon": -122.33841,
"valid": true
}
}
}
]
}
Geometri
Geometri'nin yanıt türü, ve idaltındaki geometry nesnede dataSources döndürülen geometri kimliğini içerebilir. Örneğin, Geometri verilerini GeoJSON biçiminde istemek için Çokgen Ara hizmetini kullanabilirsiniz. Bu biçimi kullanarak, bir varlık kümesi için şehir veya havaalanı ana hattı alabilirsiniz. Daha sonra bu sınır verilerini kullanarak geometri içinde bir coğrafi bölge veya Arama PO'ları ayarlayabilirsiniz.
Arama Adresi veya Arama Benzeri yanıtları, ve idaltındaki geometry nesnede dataSources döndürülen geometri kimliğini içerebilir:
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-000059690938" // The geometry ID is returned in the dataSources object under "geometry" and "id".
}
}
Sonraki adımlar
Daha fazla bilgi edinmek için bkz: