A
Destination
kullanıcının ulaşmak veya gitmek istediği önemli bir yer ya da belirli bir konumu ifade eder. Destination, gezinme noktaları, önemli yerler, girişler ve bina planları gibi bilgileri içerebilir.
Geocoding API'nin SearchDestinations uç noktası, adres, yer kimliği veya enlem ve boylam koordinatları gibi farklı giriş ölçütlerine göre çeşitli hedefler hakkında ayrıntılı bilgi almanızı sağlar.
Varış noktası arama isteği
Hedef arama isteği, şu biçimde bir URL'ye yapılan HTTP POST isteğidir:
https://geocode.googleapis.com/v4beta/geocode/destinations
JSON istek gövdesindeki veya üstbilgilerdeki tüm parametreleri POST isteğinin bir parçası olarak iletin. Örneğin:
curl -X POST -d '{
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4beta/geocode/destinations
Hedef aramak için konumu 3 şekilde belirtebilirsiniz:
- Adres
- Yer kimliği
- Enlem ve boylam koordinatları
Adrese göre hedef arama
Adresi yapılandırılmamış bir dize olarak belirtebilirsiniz. Adres coğrafi kodlaması, enlem ve boylam koordinatlarını ya da adresleri temsil etmeyen diğer yapılandırılmamış dizeleri çözmez. Bu tür dizeleri kullanan istekler desteklenmez ve hata yanıtlarına veya belirtilmemiş davranışlara yol açabilir. Desteklenmeyen sorgulara örnek olarak aşağıdakiler verilebilir:
| Sorgu türü | Örnek |
|---|---|
| Enlem ve boylam koordinatları. Bunun yerine konum sorgusu kullanın. | "37.422131,-122.084801" |
| Tek bir sorguda birden fazla yerin, yolun veya şehrin adları gibi çok fazla kavram ya da kısıtlama olması | "Market Street San Francisco San Jose Airport" |
| Posta adresi öğelerinin Google Haritalar'da gösterilmemesi |
"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco" |
| İşletmelerin, zincirlerin veya kategorilerin adları, bu öğelerin bulunmadığı konumlarla birlikte kullanıldığında | "Tesco near Dallas, Texas" (Dallas, Teksas yakınlarındaki Tesco) |
| Birden fazla yorumu olan belirsiz sorgular | "Şarj cihazı bırakma" |
| Artık kullanılmayan eski adlar | "Middlesex Birleşik Krallık" |
| Coğrafi olmayan öğeler veya amaç | "Ventura Limanı'nda kaç tekne var?" |
| Resmi olmayan veya kişisel adlar |
"The Jenga" "The Helter Skelter" |
| Büyük siyasi birimler (şehirler, eyaletler, ülkeler) |
"New York City" "California" "USA" |
| Belirli adreslerin olmadığı rotalar |
"1st Ave., NYC, NY" "I-95" |
curl -X POST -d '{
"addressQuery": {
"addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4beta/geocode/destinations
veya postalAddress olarak:
curl -X POST -d '{
"addressQuery": {
"address": {
"addressLines": ["601 S Bernardo Ave"],
"locality": "Sunnyvale",
"postalCode": "94087",
"administrativeArea": "CA",
"regionCode": "US"
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4beta/geocode/destinations
Genellikle bir HTML formunda yakalanan adres bileşenlerini işlerken postalAddress biçimini kullanırsınız.
Yer kimliğine göre hedef arama
Yer kimliği sağlayarak bir hedefi alabilirsiniz:
curl -X POST -d '{
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4beta/geocode/destinations
Desteklenen yer kimlikleri
Search Destinations uç noktası, belirli ve gezilebilir hedefleri temsil eden yer kimlikleriyle en iyi şekilde çalışır.
establishment, point_of_interest, premise, street_address ve subpremise gibi türler için yer kimlikleri genellikle desteklenir.
Adres aralıklarından (örneğin, "10-20 Main St") çıkarılanlar, belirli bir numarası olmayan bir rotanın bölümleri veya artı kodları gibi ayrı konumları temsil etmeyen yer kimlikleri desteklenmez.
Yer kimliklerini bulmak için Yer Adı Otomatik Tamamlama'yı kullanırken uyumluluğu sağlamak amacıyla sonuçları türe göre filtrelemeyi düşünebilirsiniz. Yalnızca yukarıda listelenen desteklenen türleri dahil etmek için Otomatik Tamamlama isteklerinizde includedPrimaryTypes parametresini kullanabilirsiniz:
"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]
Bu sayede, Yer Adı Otomatik Tamamlama tarafından döndürülen yer kimliklerinin, Arama Hedefleri yöntemiyle en uyumlu olması sağlanır. establishment türünün geniş olduğunu unutmayın. Bu filtre, birçok işletme konumunu yakalamak için gerekli olsa da natural_feature türleri için Yer Adı Otomatik Tamamlama sonuçlarını da içerebilir. Bu türler, arama hedeflerinde yalnızca sınırlı destek sunar.
Konuma göre hedef arama
Enlem ve boylam koordinatlarını girerek bir hedef arayabilirsiniz:
curl -X POST -d '{
"locationQuery": {
"location": {
"latitude": 37.37348780,
"longitude": -122.05678064
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4beta/geocode/destinations
İstek göndermek için OAuth'u kullanma
Geocoding API v4, kimlik doğrulama için OAuth 2.0'ı destekler. Coğrafi Kodlama API'si ile OAuth'u kullanmak için OAuth jetonuna doğru kapsam atanmalıdır. Geocoding API, Destinations uç noktasıyla kullanılmak üzere aşağıdaki kapsamları destekler:
https://www.googleapis.com/auth/maps-platform.geocode— Tüm Geocoding API uç noktalarıyla kullanılır.
Ayrıca, tüm Geocoding API uç noktaları için genel https://www.googleapis.com/auth/cloud-platform
kapsamını kullanabilirsiniz. Bu kapsam, tüm uç noktalara erişime izin veren genel bir kapsam olduğundan geliştirme sırasında kullanışlıdır ancak üretimde kullanışlı değildir.
Daha fazla bilgi ve örnek için OAuth'u kullanma başlıklı makaleyi inceleyin.
Hedef arama yanıtı
Arama Hedefleri yanıtı, konum hakkında zengin ve yakın çevreye özel bağlam bilgisi sağlar.
Bu bölümde, temel yanıt alanları açıklanmaktadır. Tüm yanıt alanları hakkında ayrıntılı bilgi için API Referansı'na bakın.
primary
İstekteki sorgu tarafından tanımlanan ana yer.
containingPlaces
Birincil hedefin parçası olduğu daha büyük kuruluşlar (örneğin, bir mağazanın bulunduğu alışveriş merkezi).
subDestinations
Birincil hedefteki daha ayrıntılı konumlar (örneğin, bir binadaki daireler).
entrances
entrances[] dizisindeki nesnelerde aşağıdaki alanlar bulunur:
locationBir giriş ve çıkış noktasının konumunu tanımlayan tek bir enlem/boylam koordinat çifti.
entrance_tags[]Girişin özelliklerini açıklayan bir giriş etiketleri dizisi. Aşağıdaki değer desteklenir:
"PREFERRED"Bu girişin, döndürülen yere fiziksel erişim sağlama olasılığının yüksek olduğunu gösterir. Bir yerin birden fazla tercih edilen girişi olabilir. Bir giriş bu etikete sahip değilse girişin fiziksel olarak aynı binada olduğu ancak mekana erişim sağlamayabileceği anlamına gelir.
Örneğin, döndürülen yer bir alışveriş merkezindeki bir restoransa
"PREFERRED"girişleri, doğrudan restorana giden girişler olur. Döndürülen diğer girişler ise binanın diğer girişleri (ör. alışveriş merkezindeki diğer restoranların girişleri) olur.Döndürülen yerin kendisi bir binaysa
"PREFERRED"girişleri, binanın "ana" kısmına giden girişler olur. Örneğin, bir alışveriş merkezinde"PREFERRED"girişleri, ana fuaye alanına erişime izin veren girişlerdir. Ancak bir giriş yalnızca binanın yan tarafındaki bir mağazaya erişim sağlıyorsa bu giriş"PREFERRED"girişi olmaz.
structureType
Bu yerin temsil ettiği yapı türü.
POINTNokta konumu.
SECTIONBir binanın alt bölümü.
BUILDINGBir bina.
GROUNDSGenellikle üniversite kampüsü, apartman kompleksi veya alışveriş merkezi gibi birden fazla binanın bulunduğu geniş bir alan.
navigationPoints
Coğrafi kodlama yanıtındaki navigationPoints alanı, yere gitmek için kullanışlı olan noktaların listesini içerir. Daha net bir ifadeyle, bu noktalar, bir yerden başka bir yere yol ağı üzerinden rota oluşturulurken başlangıç veya bitiş noktası olarak kullanılmalıdır. Her gezinme noktası aşağıdaki değerleri içerir:
navigationPointToken,navigationPointsalanındaki bağlamsal bilgileri içeren bir jetondur. Bu jetonu, uygulamanızdaki rota oluşturma ve nehir deneyimini iyileştirmek için rota oluşturma ve navigasyon API'lerine gönderebilirsiniz. Daha fazla bilgi için Navigasyon noktası jetonlarını kullanarak rota oluşturma başlıklı makaleyi inceleyin.location, gezinme noktasının enlem ve boylam değerini içerir. Bu konum her zaman yol ağına çok yakındır ve bir yere gitmek veya bir yerden gelmek için ideal bir durma ya da başlangıç noktasıdır. Nokta, yerin bulunduğu yol tarafını net bir şekilde işaretlemek için kasıtlı olarak yolun merkez çizgisinden biraz uzağa yerleştirilir.travelModes, gezinme noktasına erişilebilen ulaşım modlarının listesidir:"DRIVE", arabayla yol tariflerine karşılık gelen ulaşım şeklidir."WALK", yürüme yol tariflerine karşılık gelen ulaşım şeklidir.
usages, gezinme noktası tarafından desteklenen kullanımların listesidir. Kullanım alanları:"DROPOFF""PICKUP""PARKING"
arrivalSummary
Varışa yardımcı olacak yapay zeka destekli analizler. Yapay zeka destekli özetler bölümünü inceleyin.
landmarks
Kullanıcıların varış noktasının çevresini anlamasına yardımcı olacak yakındaki önemli yerler.
Yanıt biçimi
SearchDestinations, aşağıdaki JSON biçiminde bir
SearchDestinationsResponse
döndürür:
{ "destinations": [ { "primary": { "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w", "displayName": { "text": "Arby's", "languageCode": "en" }, "primaryType": "fast_food_restaurant", "types": [ "fast_food_restaurant", "sandwich_shop", "deli", "meal_takeaway", "food_delivery", "american_restaurant", "restaurant", "food_store", "store", "food", "point_of_interest", "establishment" ], "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "601 S Bernardo Ave" ] }, "structureType": "BUILDING", "location": { "latitude": 37.3734545, "longitude": -122.05693269999998 }, "displayPolygon": { "type": "Polygon", "coordinates": [ [ [ -122.056930138027, 37.3735253692531 ], [ -122.056960139391, 37.3735372663597 ], [ -122.056994129366, 37.3734828786847 ], [ -122.056969677395, 37.3734731161089 ], [ -122.057061762447, 37.3733261309656 ], [ -122.056979388817, 37.3732935577128 ], [ -122.056798860285, 37.3735818838642 ], [ -122.056875858081, 37.3736121235316 ], [ -122.056930138027, 37.3735253692531 ] ] ] } }, "containingPlaces": [ { "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw", "displayName": { "text": "Cherry Chase Shopping Center", "languageCode": "en" }, "primaryType": "shopping_mall", "types": [ "shopping_mall", "point_of_interest", "establishment" ], "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087-1020", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "663 S Bernardo Ave" ] }, "structureType": "GROUNDS", "location": { "latitude": 37.3731231, "longitude": -122.0578211 }, "displayPolygon": { "type": "Polygon", "coordinates": [ [ [ -122.057112227103, 37.3714618008523 ], [ -122.057076849821, 37.3715743611411 ], [ -122.056963607756, 37.3719081793948 ], [ -122.056865279559, 37.3722026053835 ], [ -122.056687872374, 37.3727258358476 ], [ -122.056580005889, 37.3730511370747 ], [ -122.056498845827, 37.3732994782583 ], [ -122.056338259713, 37.3737878663325 ], [ -122.056618678291, 37.373887693582 ], [ -122.056912102521, 37.3740010327191 ], [ -122.057532418159, 37.3742476426462 ], [ -122.057673926626, 37.3742441740031 ], [ -122.057735663106, 37.3742328516943 ], [ -122.057766531332, 37.3742220604378 ], [ -122.057797572967, 37.37420520725 ], [ -122.057828267759, 37.3741852342085 ], [ -122.058060299297, 37.3740060842535 ], [ -122.058199726081, 37.3737861673422 ], [ -122.05836707267, 37.373524542556 ], [ -122.058569622393, 37.3732018598683 ], [ -122.0587638478, 37.3728890198039 ], [ -122.058934661823, 37.3726036257774 ], [ -122.059164956851, 37.3722498383629 ], [ -122.058997784906, 37.3721804442035 ], [ -122.057936479838, 37.3717605636234 ], [ -122.057495827092, 37.3715860151634 ], [ -122.057112227103, 37.3714618008523 ] ] ] } } ], "landmarks": [ { "place": { "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg", "displayName": { "text": "Chase Bank", "languageCode": "en" }, "primaryType": "bank", "types": [ "bank", "atm", "finance", "point_of_interest", "establishment" ], "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1234 W El Camino Real" ] }, "structureType": "POINT", "location": { "latitude": 37.373579, "longitude": -122.05752700000001 } }, "relationalDescription": { "text": "Near Chase Bank", "languageCode": "en" }, "tags": [ "ARRIVAL", "ADDRESS" ], "straightLineDistanceMeters": 61.182193756103516, "travelDistanceMeters": 63.075645446777344 }, { "place": { "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14", "displayName": { "text": "Safeway", "languageCode": "en" }, "primaryType": "grocery_store", "types": [ "grocery_store", "butcher_shop", "florist", "deli", "supermarket", "bakery", "food_delivery", "market", "manufacturer", "food_store", "store", "food", "service", "point_of_interest", "establishment" ], "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "639 S Bernardo Ave" ] }, "structureType": "POINT", "location": { "latitude": 37.3727912, "longitude": -122.0581172 } }, "relationalDescription": { "text": "Around the corner from Safeway", "languageCode": "en" }, "tags": [ "ARRIVAL", "ADDRESS" ], "straightLineDistanceMeters": 158.65606689453125, "travelDistanceMeters": 131.1669921875 }, { "place": { "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk", "displayName": { "text": "Oil Changers", "languageCode": "en" }, "types": [ "car_repair", "service", "point_of_interest", "establishment" ], "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1240 W El Camino Real" ] }, "structureType": "POINT", "location": { "latitude": 37.3743054, "longitude": -122.0584272 } }, "relationalDescription": { "text": "Down the road from Oil Changers", "languageCode": "en" }, "tags": [ "ARRIVAL" ], "straightLineDistanceMeters": 140.52459716796875, "travelDistanceMeters": 143.24220275878906 }, { "place": { "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0", "displayName": { "text": "Apni Mandi Farmers Market Sunnyvale", "languageCode": "en" }, "primaryType": "grocery_store", "types": [ "grocery_store", "cake_shop", "supermarket", "asian_grocery_store", "indian_restaurant", "meal_takeaway", "bakery", "manufacturer", "wholesaler", "restaurant", "food_store", "store", "food", "point_of_interest", "establishment" ], "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087-1056", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1111 W El Camino Real" ] }, "structureType": "POINT", "location": { "latitude": 37.3737199, "longitude": -122.0522958 } }, "relationalDescription": { "text": "Near Apni Mandi Farmers Market Sunnyvale", "languageCode": "en" }, "tags": [ "ADDRESS" ], "straightLineDistanceMeters": 410.37435913085938, "travelDistanceMeters": 479.49893188476562 }, { "place": { "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs", "displayName": { "text": "Starbird Chicken", "languageCode": "en" }, "primaryType": "chicken_restaurant", "types": [ "chicken_restaurant", "fast_food_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087-1028", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1241 W El Camino Real" ] }, "structureType": "BUILDING", "location": { "latitude": 37.3746764, "longitude": -122.05708860000001 }, "displayPolygon": { "coordinates": [ [ [ -122.057003840785, 37.3747648209809 ], [ -122.057136852459, 37.3747919153144 ], [ -122.057205005705, 37.3745815131859 ], [ -122.057071994114, 37.3745544186944 ], [ -122.057003840785, 37.3747648209809 ] ] ], "type": "Polygon" } }, "relationalDescription": { "text": "Near Starbird Chicken", "languageCode": "en" }, "tags": [ "ADDRESS" ], "straightLineDistanceMeters": 87.348007202148438, "travelDistanceMeters": 214.08084106445312 } ], "entrances": [ { "location": { "latitude": 37.3735328, "longitude": -122.05694879999999 }, "tags": [ "PREFERRED" ], "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w" } ], "navigationPoints": [ { "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4", "location": { "latitude": 37.3738659, "longitude": -122.05693620000001 }, "travelModes": [ "DRIVE", "WALK" ], "usages": [ "PARKING" ] } ] } ] }
Gerekli parametreler
- Hedef için aranacak adresi, yeri veya konumu belirten aşağıdaki 3 parametreden biri API isteğinde olmalıdır:
addressQuery: Aranacak adres.place: Aranacak yerin yer kimliği.locationQuery- Aranacak konumun enlem ve boylam koordinatları.
FieldMask
Yanıt alan maskesi oluşturarak yanıtta döndürülecek alanların listesini belirtin. Yanıt alan maskesini,
$fieldsveyafieldsURL parametresini ya daX-Goog-FieldMaskHTTP üst bilgisini kullanarak yönteme iletin. Örneğin, aşağıdaki istek yalnızca birincil hedefin girişlerini, gezinme noktalarını ve yer kimliğini döndürür.curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \ -H "X-Goog-Api-Key: API_KEY" \ -H "Content-Type: application/json" \ -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \ https://geocode.googleapis.com/v4beta/geocode/destinationsYanıtta varsayılan olarak döndürülen alanların listesi yoktur. Alan maskesini atlarsanız yöntem hata döndürür. Tüm alanları döndürmek için alan maskesini
*olarak ayarlayın. Daha fazla bilgi için Döndürülecek alanları seçme bölümüne bakın.
İsteğe bağlı parametreler
-
travelModes
Hangi
navigationPointstürlerinin döndürüleceğini belirtir. Diğer seyahat modlarına ait gezinme noktaları filtrelenir.travelModesayarlanmamışsa tüm ulaşım şekillerinin gezinme noktaları döndürülebilir. languageCode
Sonuçların döndürüleceği dil.
- Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediği için bu liste kapsamlı olmayabilir.
-
languageCodesağlanmazsa API varsayılan olarakendeğerini kullanır. Geçersiz bir dil kodu belirtirseniz APIINVALID_ARGUMENThatası döndürür. - API, hem kullanıcı hem de yerel halk tarafından okunabilir bir açık adres sağlamak için elinden geleni yapar. Bu hedefi gerçekleştirmek için tercih edilen dili dikkate alarak gerekirse kullanıcının okuyabileceği bir alfabeye çevrilmiş, yerel dildeki sokak adreslerini döndürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü aynı dilde döndürülür. Bu dil, ilk bileşenden seçilir.
- Bir ad tercih edilen dilde kullanılamıyorsa API en yakın eşleşmeyi kullanır.
- Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile bağlı olarak farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlılar.
regionCode
Bölge kodu, iki karakterli CLDR kodu değeri olarak. Varsayılan değer yoktur. Çoğu CLDR kodu, ISO 3166-1 kodlarıyla aynıdır.
Bir adrese coğrafi kodlama uygularken (ileri coğrafi kodlama) bu parametre, hizmetin sonuçlarını belirtilen bölgeyle sınırlayabilir ancak tamamen kısıtlayamaz. Bir konum veya yer coğrafi olarak kodlanırken (tersine coğrafi kodlama veya yer coğrafi kodlama), bu parametre adresi biçimlendirmek için kullanılabilir. Bu parametre, her durumda geçerli yasaya göre sonuçları etkileyebilir.
-
placeFilter
locationQueryArama sonuçlarını, yalnızca binalar olan hedefleri veya yalnızca net adresleri olan hedefleri döndürme gibi gereksinimlerinizi karşılayacak şekilde filtrelemenizi sağlar.Yapısal ayrıntı düzeyine göre filtreleme
structureTypefiltresi, sorgu tarafından döndürülen yapı türlerini belirtmenize olanak tanır:- Binaları Ayırma: Haritada bina ana hatlarını göstermek veya belirli bir yapı hakkında ayrıntılı bilgi edinmek için
"structureType": "BUILDING"simgesini kullanın. - Kompleksleri Anlama: Birincil sonucun genel alan olduğundan emin olmak için
"structureType": "GROUNDS"simgesini kullanın. Bu özellik, üniversite kampüsleri veya alışveriş merkezleri gibi daha büyük alanlar için sorgu gönderirken faydalıdır. - Birimlere/Bölümlere Odaklanma: Bir binadaki bölümleri tanımlamak için
"structureType": "SECTION"kullanın.
Faydalı adresler sağlama
Bazı yerlerin açık adresleri yoktur.
addressabilityfiltresi, sonuçlarınızdaki adreslerin kalitesini kontrol etmenize yardımcı olur:- Net Birincil Adres Zorunlu Kıl: Ana hedef sonucunun her zaman sokak düzeyinde bir adresi veya adı olmasını sağlamak için
"addressability": "PRIMARY"kullanın. Bu, net bir adresin önemli olduğu gezinme veya görüntüleme amaçları için yararlıdır. - Alt Hedeflerde Adreslere İzin Ver: Birincil yerin adresi olmayabilir ancak içindeki birimlerin (ör. bir binadaki daireler) adresi olabilir. Bu gibi durumlarda
"addressability": "WEAK", en azından birincil yerin veya alt hedeflerinden birinin adresinin olmasını sağlar. - Herhangi bir sonuç: Adres varlığı kullanım alanınızla alakalı değilse
"addressability": "ANY"kullanın.
Örnek: Adreslenebilir Binalar İçin Filtreleme
curl -X POST -d '{ "locationQuery": { "location": { "latitude": 37.37348780, "longitude": -122.05678064 }, "placeFilter": { "structureType": "BUILDING", "addressability": "PRIMARY" } }, "languageCode": "en" }' \\ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\ -H "X-Goog-FieldMask: place" \\ https://geocode.googleapis.com/v4beta/geocode/destinations - Binaları Ayırma: Haritada bina ana hatlarını göstermek veya belirli bir yapı hakkında ayrıntılı bilgi edinmek için
Geri bildirim
Bu, Geocoding API'nin deneysel bir uç noktasıdır. geocoding-feedback-channel@google.com adresinden geri bildirimlerinizi iletebilirsiniz.