Search - Get Reverse Geocoding Batch
Gunakan untuk mengirim batch kueri ke REverse Geocoding API dalam satu permintaan.
Get Reverse Geocoding Batch
API adalah permintaan HTTP POST
yang mengirim batch hingga 100 kueri ke REverse Geocoding API menggunakan satu permintaan.
Kirim Permintaan Batch Sinkron
API Sinkron direkomendasikan untuk permintaan batch yang ringan. Ketika layanan menerima permintaan, layanan akan merespons segera setelah item batch dihitung dan tidak akan ada kemungkinan untuk mengambil hasilnya nanti. API Sinkron akan mengembalikan kesalahan waktu habis (respons 408) jika permintaan memakan waktu lebih dari 60 detik. Jumlah item batch dibatasi hingga 100 untuk API ini.
POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01
Isi POST untuk Permintaan Batch
Untuk mengirim kueri geocoding terbalik , Anda akan menggunakan POST
permintaan di mana isi permintaan akan berisi batchItems
array dalam json
format dan Content-Type
header akan diatur ke application/json
. Berikut adalah isi permintaan sampel yang berisi 2 kueri geocoding terbalik :
{
"batchItems": [
{
"coordinates": [-122.128275, 47.639429],
"resultTypes": ["Address", "PopulatedPlace"]
},
{
"coordinates": [-122.341979399674, 47.6095253501216]
}
]
}
Objek batchItem geocoding terbalik dapat menerima salah satu parameter URIgeocoding terbalik yang didukung.
Batch harus berisi setidaknya 1 kueri.
Model Respons Batch
Respons batch berisi summary
komponen yang menunjukkan totalRequests
bahwa yang merupakan bagian dari permintaan batch asli dan successfulRequests
yaitu kueri yang berhasil dijalankan. Respons batch juga menyertakan batchItems
array yang berisi respons untuk setiap kueri dalam permintaan batch.
batchItems
akan berisi hasil dalam urutan yang sama persis dengan kueri asli yang dikirim dalam permintaan batch. Setiap item adalah dari salah satu jenis berikut:
GeocodingResponse
- Jika kueri berhasil diselesaikan.Error
- Jika kueri gagal. Respons akan berisicode
danmessage
dalam hal ini.
POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
api-version
|
query | True |
string |
Nomor versi API Azure Maps. |
Header Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
x-ms-client-id |
string |
Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan Azure Active Directory. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun sarana manajemen Azure Maps. Untuk menggunakan keamanan Azure Active Directory di Azure Maps, lihat artikel berikut ini untuk panduan. |
|
Accept-Language |
string |
Bahasa di mana hasil pencarian harus dikembalikan. Silakan merujuk ke Bahasa yang Didukung untuk detailnya. |
Isi Permintaan
Nama | Jenis | Deskripsi |
---|---|---|
batchItems |
Daftar kueri yang akan diproses. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Terjadi kesalahan tak terduga. |
Keamanan
AADToken
Ini adalah Alur Microsoft Entra OAuth 2.0 . Saat dipasangkan dengan kontrol akses berbasis peran Azure , kontrol akses tersebut dapat digunakan untuk mengontrol akses ke REST API Azure Maps. Kontrol akses berbasis peran Azure digunakan untuk menunjuk akses ke satu atau beberapa akun sumber daya atau sub-sumber daya Azure Maps. Setiap pengguna, grup, atau perwakilan layanan dapat diberikan akses melalui peran bawaan atau peran kustom yang terdiri dari satu atau beberapa izin ke REST API Azure Maps.
Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi. Singkatnya, definisi keamanan ini menyediakan solusi untuk pemodelan aplikasi melalui objek yang mampu mengontrol akses pada API dan cakupan tertentu.
Catatan
- Definisi keamanan ini memerlukan penggunaan
x-ms-client-id
header untuk menunjukkan sumber daya Azure Maps mana yang meminta akses aplikasi. Ini dapat diperoleh dari API manajemen Maps. -
Authorization URL
khusus untuk instans cloud publik Azure. Sovereign cloud memiliki URL Otorisasi yang unik dan konfigurasi ID Microsoft Entra. - Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.
- Penggunaan Azure Maps Web SDK memungkinkan penyiapan berbasis konfigurasi aplikasi untuk beberapa kasus penggunaan.
- Untuk informasi selengkapnya tentang platform identitas Microsoft, lihat Gambaran umum platform identitas Microsoft.
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
Nama | Deskripsi |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Ini adalah kunci bersama yang disediakan saat membuat sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.
Dengan kunci ini, aplikasi apa pun berwenang untuk mengakses semua REST API. Dengan kata lain, ini saat ini dapat diperlakukan sebagai kunci master ke akun tempat mereka dikeluarkan.
Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah menggunakan akses server-ke-server dari REST API Azure Maps tempat kunci ini dapat disimpan dengan aman.
Jenis:
apiKey
Dalam:
header
SAS Token
Ini adalah token tanda tangan akses bersama dibuat dari operasi Daftar SAS pada sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.
Dengan token ini, aplikasi apa pun berwenang untuk mengakses dengan kontrol akses berbasis peran Azure dan kontrol fine-grain ke kedaluwarsa, tarif, dan wilayah penggunaan untuk token tertentu. Dengan kata lain, Token SAS dapat digunakan untuk memungkinkan aplikasi mengontrol akses dengan cara yang lebih aman daripada kunci bersama.
Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah mengonfigurasi daftar spesifik asal yang diizinkan pada sumber daya akun Peta untuk membatasi penyalahgunaan penyalahgunaan dan memperbarui Token SAS secara teratur.
Jenis:
apiKey
Dalam:
header
Contoh
A Reverse Geocoding Batch API call containing 2 Reverse Geocoding queries
Permintaan sampel
POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01
{
"batchItems": [
{
"coordinates": [
-122.128275,
47.639429
],
"resultTypes": [
"Address",
"PopulatedPlace"
],
"optionalId": "4C3681A6C8AA4AC3441412763A2A25C81444DC8B"
},
{
"coordinates": [
-122.341979399674,
47.6095253501216
],
"optionalId": "6M9W39P12SNHGAIZ4JQ7F57NWJLV2BRYEQRD7OH7"
}
]
}
Respon sampel
{
"summary": {
"successfulRequests": 1,
"totalRequests": 2
},
"batchItems": [
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"type": "Address",
"confidence": "High",
"matchCodes": [
"Good"
],
"address": {
"locality": "Redmond",
"adminDistricts": [
{
"shortName": "WA"
},
{
"shortName": "King"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "98052",
"formattedAddress": "1 Microsoft Way, Redmond, WA 98052",
"addressLine": "1 Microsoft Way"
},
"geocodePoints": [
{
"geometry": {
"type": "Point",
"coordinates": [
-122.128275,
47.639429
]
},
"calculationMethod": "Rooftop",
"usageTypes": [
"Display",
"Route"
]
},
{
"geometry": {
"type": "Point",
"coordinates": [
-122.127028,
47.638545
]
},
"calculationMethod": "Rooftop",
"usageTypes": [
"Route"
]
}
]
},
"geometry": {
"type": "Point",
"coordinates": [
-122.128275,
47.639429
]
},
"bbox": [
-122.1359181505759,
47.63556628242932,
-122.1206318494241,
47.643291717570676
]
}
]
},
{
"optionalId": "3K5O3Y832J2YV6D7XNGUSM4ECCUGDEFN172CJQNN",
"error": {
"code": "400 Bad Request",
"message": "The provided coordinates in query are invalid, out of range, or not in the expected format"
}
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Address |
Alamat hasil |
Admin |
Nama subdivisi di negara atau wilayah untuk alamat. Elemen ini biasanya diperlakukan sebagai subdivisi administratif urutan pertama, tetapi dalam beberapa kasus juga berisi subdivisi urutan kedua, ketiga, atau keempat di negara, dependensi, atau wilayah. |
Calculation |
Metode yang digunakan untuk menghitung titik geocode. |
Confidence |
Tingkat keyakinan bahwa hasil lokasi yang dikodekan secara geografis adalah kecocokan. Gunakan nilai ini dengan kode kecocokan untuk menentukan informasi lebih lengkap tentang kecocokan. Keyakinan lokasi yang di-geocode didasarkan pada banyak faktor termasuk kepentingan relatif dari lokasi geocoded dan lokasi pengguna, jika ditentukan. |
Country |
|
Error |
Info tambahan kesalahan manajemen sumber daya. |
Error |
Detail kesalahan. |
Error |
Respons kesalahan |
Feature |
Jenis objek FeatureCollection harus FeatureCollection. |
Features |
|
Feature |
Jenis fitur harus Fitur. |
Geocode |
Kumpulan titik geocode yang berbeda dalam cara penghitungannya dan penggunaan yang disarankan. |
Geocoding |
Objek ini dikembalikan dari panggilan layanan Batch Geocoding yang berhasil. |
Geocoding |
|
Geo |
Jenis geometri yang valid |
Intersection |
Alamat hasilnya. |
Match |
Satu atau beberapa nilai kode yang cocok yang mewakili tingkat geocoding untuk setiap lokasi dalam respons. Misalnya, lokasi yang dikodekan secara geografis Demikian pula, lokasi yang dikodekan secara geografis Nilai yang mungkin adalah:
|
Properties | |
Result |
Tentukan jenis entitas yang Anda inginkan dalam respons. Hanya jenis yang Anda tentukan yang akan dikembalikan. Jika titik tidak dapat dipetakan ke jenis entitas yang Anda tentukan, tidak ada informasi lokasi yang dikembalikan dalam respons. Nilai default adalah semua entitas yang mungkin. Daftar jenis entitas yang dipisahkan koma dipilih dari opsi berikut.
Jenis entitas ini diurutkan dari entitas yang paling spesifik ke entitas yang paling tidak spesifik. Ketika entitas dari lebih dari satu jenis entitas ditemukan, hanya entitas yang paling spesifik yang dikembalikan. Misalnya, jika Anda menentukan Alamat dan AdminDistrict1 sebagai jenis entitas dan entitas yang ditemukan untuk kedua jenis tersebut, hanya informasi entitas Alamat yang dikembalikan dalam respons. |
Reverse |
Daftar kueri/permintaan geocoding terbalik untuk diproses. Daftar dapat berisi maksimal 100 kueri dan harus berisi setidaknya 1 kueri. |
Reverse |
Objek Kueri Batch |
Summary |
Ringkasan untuk permintaan batch |
Usage |
Penggunaan terbaik untuk titik geocode.
Setiap titik geocode didefinisikan sebagai |
Address
Alamat hasil
Nama | Jenis | Deskripsi |
---|---|---|
addressLine |
string |
AddressLine yang menyertakan Nama Dan Nomor Jalan |
adminDistricts |
Nama subdivisi di negara atau wilayah untuk alamat. Elemen ini biasanya diperlakukan sebagai subdivisi administratif urutan pertama, tetapi dalam beberapa kasus juga berisi subdivisi urutan kedua, ketiga, atau keempat di negara, dependensi, atau wilayah. |
|
countryRegion | ||
formattedAddress |
string |
Properti Alamat Yang Diformat |
intersection |
Alamat hasilnya. |
|
locality |
string |
properti lokalitas |
neighborhood |
string |
properti lingkungan |
postalCode |
string |
Properti Kode Pos |
AdminDistricts
Nama subdivisi di negara atau wilayah untuk alamat. Elemen ini biasanya diperlakukan sebagai subdivisi administratif urutan pertama, tetapi dalam beberapa kasus juga berisi subdivisi urutan kedua, ketiga, atau keempat di negara, dependensi, atau wilayah.
Nama | Jenis | Deskripsi |
---|---|---|
name |
string |
Nama untuk bidang adminDistrict yang sesuai, Untuk adminDistrict[0], ini bisa menjadi nama lengkap negara bagian seperti Washington, Untuk adminDistrict[1], ini bisa menjadi nama lengkap negara bagian |
shortName |
string |
Nama pendek untuk bidang adminDistrict yang sesuai, Untuk adminDistrict[0], ini bisa menjadi nama pendek status seperti WA, Untuk adminDistrict[1], ini bisa menjadi nama pendek kabupaten |
CalculationMethodEnum
Metode yang digunakan untuk menghitung titik geocode.
Nama | Jenis | Deskripsi |
---|---|---|
Interpolation |
string |
Titik geocode dicocokkan dengan titik di jalan menggunakan interpolasi. |
InterpolationOffset |
string |
Titik geocode dicocokkan dengan titik di jalan menggunakan interpolasi dengan offset tambahan untuk menggeser titik ke sisi jalan. |
Parcel |
string |
Titik geocode dicocokkan dengan pusat paket. |
Rooftop |
string |
Titik geocode dicocokkan dengan atap gedung. |
ConfidenceEnum
Tingkat keyakinan bahwa hasil lokasi yang dikodekan secara geografis adalah kecocokan. Gunakan nilai ini dengan kode kecocokan untuk menentukan informasi lebih lengkap tentang kecocokan.
Keyakinan lokasi yang di-geocode didasarkan pada banyak faktor termasuk kepentingan relatif dari lokasi geocoded dan lokasi pengguna, jika ditentukan.
Nama | Jenis | Deskripsi |
---|---|---|
High |
string |
Jika kepercayaan diri diatur ke Jika permintaan menyertakan lokasi atau tampilan, peringkat dapat berubah dengan tepat. Misalnya, kueri lokasi untuk "Paris" mengembalikan "Paris, Prancis" dan "Paris, TX" keduanya dengan |
Low |
string |
|
Medium |
string |
Dalam beberapa situasi, kecocokan yang dikembalikan mungkin tidak berada pada tingkat yang sama dengan informasi yang diberikan dalam permintaan. Misalnya, permintaan dapat menentukan informasi alamat dan layanan geocode mungkin hanya dapat mencocokkan kode pos. Dalam hal ini, jika layanan geocode memiliki keyakinan bahwa kode pos cocok dengan data, keyakinan diatur ke Jika informasi lokasi dalam kueri ambigu, dan tidak ada informasi tambahan untuk memberi peringkat lokasi (seperti lokasi pengguna atau kepentingan relatif lokasi), keyakinan diatur ke Jika informasi lokasi dalam kueri tidak memberikan informasi yang cukup untuk geocode lokasi tertentu, nilai lokasi yang kurang tepat dapat dikembalikan dan keyakinan diatur ke |
CountryRegion
Nama | Jenis | Deskripsi |
---|---|---|
ISO |
string |
ISO negara/wilayah |
name |
string |
nama negara/wilayah |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
info |
object |
Info tambahan. |
type |
string |
Jenis info tambahan. |
ErrorDetail
Detail kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
additionalInfo |
Info tambahan kesalahan. |
|
code |
string |
Kode kesalahan. |
details |
Detail kesalahan. |
|
message |
string |
Pesan kesalahan. |
target |
string |
Target kesalahan. |
ErrorResponse
Respons kesalahan
Nama | Jenis | Deskripsi |
---|---|---|
error |
Objek kesalahan. |
FeatureCollectionEnum
Jenis objek FeatureCollection harus FeatureCollection.
Nama | Jenis | Deskripsi |
---|---|---|
FeatureCollection |
string |
FeaturesItem
Nama | Jenis | Deskripsi |
---|---|---|
bbox |
number[] |
Kotak pembatas. Proyeksi yang digunakan - EPSG:3857. Silakan merujuk ke RFC 7946 untuk detailnya. |
geometry |
Jenis geometri yang valid |
|
id |
string |
ID untuk fitur yang dikembalikan |
properties | ||
type |
Jenis fitur harus Fitur. |
FeatureTypeEnum
Jenis fitur harus Fitur.
Nama | Jenis | Deskripsi |
---|---|---|
Feature |
string |
GeocodePoints
Kumpulan titik geocode yang berbeda dalam cara penghitungannya dan penggunaan yang disarankan.
Nama | Jenis | Deskripsi |
---|---|---|
calculationMethod |
Metode yang digunakan untuk menghitung titik geocode. |
|
geometry |
Jenis geometri yang valid |
|
usageTypes |
Penggunaan terbaik untuk titik geocode.
Setiap titik geocode didefinisikan sebagai |
GeocodingBatchResponse
Objek ini dikembalikan dari panggilan layanan Batch Geocoding yang berhasil.
Nama | Jenis | Deskripsi |
---|---|---|
batchItems |
Array yang berisi hasil batch. |
|
nextLink |
string |
adalah tautan ke halaman berikutnya dari fitur yang dikembalikan. Jika itu halaman terakhir, tidak ada bidang ini. |
summary |
Ringkasan untuk permintaan batch |
GeocodingBatchResponseItem
Nama | Jenis | Deskripsi |
---|---|---|
error |
Detail kesalahan. |
|
features | ||
nextLink |
string |
adalah tautan ke halaman berikutnya dari fitur yang dikembalikan. Jika itu halaman terakhir, tidak ada bidang ini. |
optionalId |
string |
id batchItem yang akan sama dengan id dalam permintaan |
type |
Jenis objek FeatureCollection harus FeatureCollection. |
GeoJsonPoint
Jenis geometri yang valid GeoJSON Point
. Silakan merujuk ke RFC 7946 untuk detailnya.
Nama | Jenis | Deskripsi |
---|---|---|
bbox |
number[] |
Kotak pembatas. Proyeksi yang digunakan - EPSG:3857. Silakan merujuk ke RFC 7946 untuk detailnya. |
coordinates |
number[] |
|
type |
string:
Point |
Menentukan jenisnya |
Intersection
Alamat hasilnya.
Nama | Jenis | Deskripsi |
---|---|---|
baseStreet |
string |
Jalan utama untuk lokasi. |
displayName |
string |
Nama lengkap persimpangan. |
intersectionType |
string |
Jenis persimpangan. |
secondaryStreet1 |
string |
Jalan persimpangan pertama. |
secondaryStreet2 |
string |
Jika ada, jalan kedua berpotongan. |
MatchCodesEnum
Satu atau beberapa nilai kode yang cocok yang mewakili tingkat geocoding untuk setiap lokasi dalam respons.
Misalnya, lokasi yang dikodekan secara geografis Good
dengan kode kecocokan dan Ambiguous
berarti bahwa lebih dari satu lokasi geocode ditemukan untuk informasi lokasi dan bahwa layanan geocode tidak memiliki hierarki pencarian untuk menemukan kecocokan.
Demikian pula, lokasi yang dikodekan secara geografis Ambiguous
dengan kode kecocokan dan UpHierarchy
menyiratkan bahwa lokasi geocode tidak dapat ditemukan yang cocok dengan semua informasi lokasi yang disediakan, sehingga layanan geocode harus mencari hierarki dan menemukan beberapa kecocokan pada tingkat tersebut. Contoh hasil dan UpHierarchy
adalah ketika Anda memberikan informasi alamat lengkap, tetapi layanan geocode tidak dapat menemukan kecocokan Ambiguous
untuk alamat jalan dan sebaliknya mengembalikan informasi untuk lebih dari satu nilai RoadBlock.
Nilai yang mungkin adalah:
Good
: Lokasi hanya memiliki satu kecocokan atau semua kecocokan yang dikembalikan dianggap cocok dengan kuat. Misalnya, kueri untuk New York mengembalikan beberapa Kecocokan yang baik.
Ambiguous
: Lokasi adalah salah satu dari serangkaian kemungkinan kecocokan. Misalnya, saat Anda meminta alamat jalan 128 Main St., respons dapat mengembalikan dua lokasi untuk 128 North Main St. dan 128 South Main St. karena tidak ada cukup informasi untuk menentukan opsi mana yang akan dipilih.
UpHierarchy
: Lokasi mewakili perpindahan ke atas hierarki geografis. Ini terjadi ketika kecocokan untuk permintaan lokasi tidak ditemukan, sehingga hasil yang kurang tepat dikembalikan. Misalnya, jika kecocokan untuk alamat yang diminta tidak dapat ditemukan, maka kode UpHierarchy
kecocokan dengan jenis entitas RoadBlock dapat dikembalikan.
Nama | Jenis | Deskripsi |
---|---|---|
Ambiguous |
string |
|
Good |
string |
|
UpHierarchy |
string |
Properties
Nama | Jenis | Deskripsi |
---|---|---|
address |
Alamat hasil |
|
confidence |
Tingkat keyakinan bahwa hasil lokasi yang dikodekan secara geografis adalah kecocokan. Gunakan nilai ini dengan kode kecocokan untuk menentukan informasi lebih lengkap tentang kecocokan. Keyakinan lokasi yang di-geocode didasarkan pada banyak faktor termasuk kepentingan relatif dari lokasi geocoded dan lokasi pengguna, jika ditentukan. |
|
geocodePoints |
Kumpulan titik geocode yang berbeda dalam cara penghitungannya dan penggunaan yang disarankan. |
|
matchCodes |
Satu atau beberapa nilai kode yang cocok yang mewakili tingkat geocoding untuk setiap lokasi dalam respons. Misalnya, lokasi yang dikodekan secara geografis Demikian pula, lokasi yang dikodekan secara geografis Nilai yang mungkin adalah:
|
|
type |
string |
Salah satu:
|
ResultTypeEnum
Tentukan jenis entitas yang Anda inginkan dalam respons. Hanya jenis yang Anda tentukan yang akan dikembalikan. Jika titik tidak dapat dipetakan ke jenis entitas yang Anda tentukan, tidak ada informasi lokasi yang dikembalikan dalam respons. Nilai default adalah semua entitas yang mungkin. Daftar jenis entitas yang dipisahkan koma dipilih dari opsi berikut.
- Alamat
- Neighborhood
- PopulatedPlace
- Kode pos1
- AdminDivision1
- AdminDivision2
- CountryRegion
Jenis entitas ini diurutkan dari entitas yang paling spesifik ke entitas yang paling tidak spesifik. Ketika entitas dari lebih dari satu jenis entitas ditemukan, hanya entitas yang paling spesifik yang dikembalikan. Misalnya, jika Anda menentukan Alamat dan AdminDistrict1 sebagai jenis entitas dan entitas yang ditemukan untuk kedua jenis tersebut, hanya informasi entitas Alamat yang dikembalikan dalam respons.
Nama | Jenis | Deskripsi |
---|---|---|
Address |
string |
|
AdminDivision1 |
string |
|
AdminDivision2 |
string |
|
CountryRegion |
string |
|
Neighborhood |
string |
|
PopulatedPlace |
string |
|
Postcode1 |
string |
ReverseGeocodingBatchRequestBody
Daftar kueri/permintaan geocoding terbalik untuk diproses. Daftar dapat berisi maksimal 100 kueri dan harus berisi setidaknya 1 kueri.
Nama | Jenis | Deskripsi |
---|---|---|
batchItems |
Daftar kueri yang akan diproses. |
ReverseGeocodingBatchRequestItem
Objek Kueri Batch
Nama | Jenis | Deskripsi |
---|---|---|
coordinates |
number[] |
Koordinat lokasi yang ingin Anda balikkan geocodenya. Contoh: [lon,lat] |
optionalId |
string |
id permintaan yang akan ditampilkan dalam batchItem yang sesuai |
resultTypes |
Tentukan jenis entitas yang Anda inginkan dalam respons. Hanya jenis yang Anda tentukan yang akan dikembalikan. Jika titik tidak dapat dipetakan ke jenis entitas yang Anda tentukan, tidak ada informasi lokasi yang dikembalikan dalam respons. Nilai default adalah semua entitas yang mungkin. Daftar jenis entitas yang dipisahkan koma dipilih dari opsi berikut.
Jenis entitas ini diurutkan dari entitas yang paling spesifik ke entitas yang paling tidak spesifik. Ketika entitas dari lebih dari satu jenis entitas ditemukan, hanya entitas yang paling spesifik yang dikembalikan. Misalnya, jika Anda menentukan Alamat dan AdminDistrict1 sebagai jenis entitas dan entitas yang ditemukan untuk kedua jenis tersebut, hanya informasi entitas Alamat yang dikembalikan dalam respons. |
|
view |
string |
String yang menentukan kode wilayah/negara ISO 3166-1 Alpha-2. Ini akan mengubah batas dan label geopolitik yang disengketakan untuk menyelaraskan dengan wilayah pengguna yang ditentukan. |
Summary
Ringkasan untuk permintaan batch
Nama | Jenis | Deskripsi |
---|---|---|
successfulRequests |
integer |
Jumlah permintaan yang berhasil dalam batch |
totalRequests |
integer |
Jumlah total permintaan dalam batch |
UsageTypeEnum
Penggunaan terbaik untuk titik geocode.
Setiap titik geocode didefinisikan sebagai Route
titik, Display
titik atau keduanya.
Gunakan Route
titik jika Anda membuat rute ke lokasi. Gunakan Display
titik jika Anda menampilkan lokasi di peta. Misalnya, jika lokasinya adalah taman, Route
titik dapat menentukan pintu masuk ke taman tempat Anda dapat masuk dengan mobil, dan Display
titik mungkin merupakan titik yang menentukan pusat taman.
Nama | Jenis | Deskripsi |
---|---|---|
Display |
string |
|
Route |
string |