Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Cara menggunakan SearchNearby
Bagian ini berisi berbagai cara panduan dan contoh cara menggunakannya SearchNearby.
**Topics**
+ [Cara mencari di dekatnya dari suatu posisi](how-to-search-nearby.md)
+ [Cara mencari tempat terdekat berdasarkan kategori](how-to-search-nearby-category.md)
+ [Cara mencari tempat terdekat berdasarkan jenis makanan](how-to-search-nearby-food.md)
+ [Cara mencari di sekitar berdasarkan rantai bisnis](how-to-search-nearby-business.md)
+ [Cara mencari di dekatnya di suatu negara](how-to-search-nearby-country.md)
+ [Cara mencari di dekatnya menggunakan konteks geospasial](how-to-search-nearby-geospatial.md)
# Cara mencari di dekatnya dari suatu posisi
SearchNearby API memungkinkan kueri untuk semua tempat terdekat dan tempat menarik (POI) tanpa memasukkan teks tertentu. Pengguna dapat menjelajahi lingkungan, menemukan POIs, dan lainnya menggunakan API ini. Ini membutuhkan`QueryPosition`, yang dapat mewakili lokasi perangkat, posisi berbasis IP, atau pusat viewport peta. Atau, pengguna dapat menentukan kota atau tempat untuk membiaskan hasil berdasarkan geokoordinat lokasi tersebut.
## Kasus penggunaan potensial
+ **Jelajahi terdekat POIs:** Lihat semua tempat menarik di dekat posisi saat ini.
+ **Jelajahi tempat-tempat terdekat:** Lihat semua lokasi atau tempat di dekat posisi tertentu.
## Contoh
### Cari di dekatnya dari suatu posisi
Dalam contoh ini, pencarian dilakukan dari posisi di Dubai dengan garis lintang 25.26951 dan bujur 55.30884.
------
#### [ Sample request ]
```
{
"QueryPosition": [
55.30884,
25.26951
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "هما",
"Address": {
"Label": "هما, شارع مستشفى آل مكتوم, نايف دبي, الإمارات العربية المتحدة",
"Country": {
"Code2": "AE",
"Code3": "ARE",
"Name": "الإمارات العربية المتحدة"
},
"SubRegion": {
"Name": "دبي"
},
"Locality": "دبي",
"District": "نايف",
"Street": "شارع مستشفى آل مكتوم",
"StreetComponents": [
{
"BaseName": "مستشفى آل مكتوم",
"Type": "شارع",
"TypePlacement": "BeforeBaseName",
"TypeSeparator": " ",
"Language": "ar"
}
]
},
"Position": [
55.30884,
25.26951
],
"Distance": 0,
"Categories": [
{
"Id": "department_store",
"Name": "Department Store",
"LocalizedName": "مول تجاري",
"Primary": true
}
],
"BusinessChains": [
{
"Name": "HEMA",
"Id": "HEMA"
}
]
},
{
"PlaceId": "",
"PlaceType": "Locality",
"Title": "دبي, الإمارات العربية المتحدة",
"Address": {
"Label": "دبي, الإمارات العربية المتحدة",
"Country": {
"Code2": "AE",
"Code3": "ARE",
"Name": "الإمارات العربية المتحدة"
},
"SubRegion": {
"Name": "دبي"
},
"Locality": "دبي"
},
"Position": [
55.30884,
25.26951
],
"Distance": 0,
"MapView": [
54.64906,
24.62308,
55.7371,
25.36995
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryPosition": [
55.30884,
25.26951
],
"MaxResults": 2
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position 55.30884 25.26951 \
--max-results 2
```
------
# Cara mencari tempat terdekat berdasarkan kategori
SearchNearby API memungkinkan kueri untuk tempat menarik (POI) dengan penyertaan atau pengecualian kategori tertentu. Ini dapat membantu pengguna menjelajahi lingkungan, menemukan lokal POIs, dan banyak lagi. API membutuhkan`QueryPosition`, yang dapat didasarkan pada lokasi perangkat, posisi IP, atau pusat viewport peta. Atau, pengguna dapat menentukan kota atau tempat, dan aplikasi akan membiaskan hasil berdasarkan koordinat lokasi tersebut.
Untuk mempelajari lebih lanjut tentang kategori yang didukung, lihat[Kategori filter](places-filtering.md#place-categories).
## Kasus penggunaan potensial
+ **Jelajahi fasilitas lokal:** Temukan fasilitas yang tersedia di lingkungan sekitar.
+ **Temukan tempat wisata:** Identifikasi tempat-tempat wisata di dalam kota.
+ **Rencanakan perjalanan di kota:** Atur perjalanan di sekitar yang berbeda di POIs dalam kota yang dipilih.
## Contoh
### Sertakan kategori
------
#### [ Sample request ]
```
{
"QueryPosition": [
4.35609,
50.84439
],
"Filter": {
"IncludeCategories": ["airport"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Brussels Airport",
"Address": {
"Label": "Brussels Airport, A201, 1930 Zaventem, België",
"Country": {
"Code2": "BE",
"Code3": "BEL",
"Name": "België"
},
"Region": {
"Code": "VLG",
"Name": "Vlaanderen"
},
"SubRegion": {
"Name": "Vlaams Brabant"
},
"Locality": "Zaventem",
"PostalCode": "1930",
"Street": "A201",
"StreetComponents": [
{
"BaseName": "A201",
"Language": "nl"
}
]
},
"Position": [
4.47767,
50.89452
],
"Distance": 10191,
"Categories": [
{
"Id": "airport",
"Name": "Airport",
"LocalizedName": "Luchthaven",
"Primary": true
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Internationale Luchthaven Antwerpen",
"Address": {
"Label": "Internationale Luchthaven Antwerpen, Luchthavenlei 1, 2100 Antwerpen, België",
"Country": {
"Code2": "BE",
"Code3": "BEL",
"Name": "België"
},
"Region": {
"Code": "VLG",
"Name": "Vlaanderen"
},
"SubRegion": {
"Name": "Antwerpen"
},
"Locality": "Antwerpen",
"District": "Deurne",
"PostalCode": "2100",
"Street": "Luchthavenlei",
"StreetComponents": [
{
"BaseName": "Luchthaven",
"Type": "lei",
"TypePlacement": "AfterBaseName",
"TypeSeparator": "",
"Language": "nl"
}
],
"AddressNumber": "1"
},
"Position": [
4.45083,
51.18867
],
"Distance": 38852,
"Categories": [
{
"Id": "airport",
"Name": "Airport",
"LocalizedName": "Luchthaven",
"Primary": true
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryPosition": [
4.35609,
50.84439
],
"Filter": {
"IncludeCategories": ["airport"]
},
"MaxResults": 2
}
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position 4.35609 50.84439 \
--filter '{"IncludeCategories": ["airport"]}' \
--max-results 2
```
------
### Kecualikan kategori
------
#### [ Sample request ]
```
{
"QueryPosition": [
4.35609,
50.84439
],
"Filter": {
"ExcludeCategories": ["airport"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Socialbrands Module 2",
"Address": {
"Label": "Socialbrands Module 2, Albertinaplein, 1000 Brussel, België",
"Country": {
"Code2": "BE",
"Code3": "BEL",
"Name": "België"
},
"Region": {
"Code": "BRU",
"Name": "Brussel"
},
"SubRegion": {
"Name": "Brussel"
},
"Locality": "Brussel",
"District": "Koningswijk",
"PostalCode": "1000",
"Street": "Albertinaplein",
"StreetComponents": [
{
"BaseName": "Albertina",
"Type": "plein",
"TypePlacement": "AfterBaseName",
"TypeSeparator": "",
"Language": "nl"
}
]
},
"Position": [
4.35609,
50.84439
],
"Distance": 0,
"Categories": [
{
"Id": "commercial_services",
"Name": "Commercial Services",
"LocalizedName": "Commerciële diensten",
"Primary": true
}
],
"Contacts": {
"Websites": [
{
"Value": "https://oneread.net"
}
]
},
"AccessPoints": [
{
"Position": [
4.35609,
50.84439
]
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Barman Privé",
"Address": {
"Label": "Barman Privé, Albertinaplein, 1000 Brussel, België",
"Country": {
"Code2": "BE",
"Code3": "BEL",
"Name": "België"
},
"Region": {
"Code": "BRU",
"Name": "Brussel"
},
"SubRegion": {
"Name": "Brussel"
},
"Locality": "Brussel",
"District": "Koningswijk",
"PostalCode": "1000",
"Street": "Albertinaplein",
"StreetComponents": [
{
"BaseName": "Albertina",
"Type": "plein",
"TypePlacement": "AfterBaseName",
"TypeSeparator": "",
"Language": "nl"
}
]
},
"Position": [
4.35609,
50.84439
],
"Distance": 0,
"Categories": [
{
"Id": "catering_and_other_food_services",
"Name": "Catering and Other Food Services",
"LocalizedName": "Catering- en horecadiensten",
"Primary": true
}
],
"Contacts": {
"Phones": [
{
"Value": "+32476891634"
}
]
},
"OpeningHours": [
{
"Display": [
"ma-zo: 00:00 - 24:00"
],
"OpenNow": true,
"Components": [
{
"OpenTime": "T000000",
"OpenDuration": "PT24H00M",
"Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR,SA,SU"
}
]
}
],
"AccessPoints": [
{
"Position": [
4.35609,
50.84439
]
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryPosition": [
4.35609,
50.84439
],
"Filter": {
"ExcludeCategories": ["airport"]
}
}
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position 4.35609 50.84439 \
--filter '{"ExcludeCategories": ["airport"]}' \
--max-results 2
```
------
# Cara mencari tempat terdekat berdasarkan jenis makanan
`SearchNearby`API memungkinkan Anda menanyakan restoran terdekat yang menyajikan jenis makanan tertentu. Anda juga dapat mengecualikan jenis makanan dari hasil Anda.
Anda dapat menggunakan SearchNearby API untuk memungkinkan pengguna akhir menjelajahi lingkungan dan menemukan tempat-tempat menarik. API membutuhkan QueryPosition, yang dapat berupa posisi perangkat, posisi IP, atau pusat port tampilan peta. Cara lain adalah membiarkan pengguna akhir memberikan nama kota atau nama tempat dan aplikasi dapat membiaskan hasil berdasarkan koordinat geografis.
Untuk informasi lebih lanjut tentang jenis makanan, lihat[Filter Jenis Makanan](places-filtering.md#food-type).
## Kasus penggunaan potensial
+ Jelajahi jenis makanan yang tersedia di sekitarnya.
+ Kecualikan pilihan restoran yang menyajikan jenis makanan yang membuat Anda alergi.
## Contoh
### Cari tempat terdekat berdasarkan jenis makanan
Contoh berikut menunjukkan cara mencari tempat terdekat berdasarkan jenis makanan.
------
#### [ Sample request ]
Permintaan ini mencari restoran yang menyajikan makanan China di dekat koordinat yang ditentukan.
```
{
"QueryPosition": [
12.49563,
41.90325
],
"Filter": {
"IncludeFoodTypes": ["chinese"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Bufala e Pachino",
"Address": {
"Label": "Bufala e Pachino, Via Firenze, 53, 00184 Roma RM, Italia",
"Country": {
"Code2": "IT",
"Code3": "ITA",
"Name": "Italia"
}
},
"Position": [
12.49409,
41.90237
],
"Distance": 161,
"Categories": [
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Ristorante",
"Primary": true
}
],
"FoodTypes": [
{
"LocalizedName": "Pizza",
"Id": "pizza",
"Primary": true
},
{
"LocalizedName": "Cinese",
"Id": "chinese",
"Primary": false
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryPosition": [12.49563, 41.90325],
"Filter": {
"IncludeFoodTypes": ["chinese"]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position 12.49563 41.90325 \
--filter '{"IncludeFoodTypes": ["chinese"]}'
```
------
### Tips Pengembang
+ Anda dapat menggunakan `ExludeFoodTypes` untuk mengecualikan rantai bisnis tertentu dari hasil Anda.
+ Anda dapat mengecualikan atau memasukkan beberapa jenis makanan.
# Cara mencari di sekitar berdasarkan rantai bisnis
SearchNearby API memungkinkan Anda untuk menanyakan rantai bisnis terdekat. Anda dapat menyertakan atau mengecualikan rantai bisnis tertentu dalam pencarian Anda. Fitur ini memungkinkan pengguna akhir untuk menjelajahi lingkungan, menemukan tempat menarik, dan banyak lagi.
Untuk menggunakan SearchNearby API, Anda perlu menyediakan QueryPosition, yang dapat berupa:
+ Posisi perangkat
+ Posisi berbasis IP
+ Pusat viewport peta
Atau, pengguna dapat memberikan nama kota atau tempat, dan aplikasi dapat membiaskan hasil berdasarkan koordinat geografis lokasi tersebut.
Untuk informasi selengkapnya tentang rantai bisnis yang didukung, lihat[Filter Rantai Bisnis](places-filtering.md#business-chains).
## Kasus penggunaan potensial
+ Jelajahi bisnis di sekitarnya
+ Perluas bisnis Anda dengan menemukan pelanggan B2B terdekat
## Contoh
### Cari tempat terdekat berdasarkan rantai bisnis
Contoh berikut menunjukkan cara mencari lokasi Starbucks terdekat.
------
#### [ Sample request ]
Permintaan ini mencari lokasi Starbucks di dekat koordinat yang ditentukan.
```
{
"QueryPosition": [
12.49563,
41.90325
],
"Filter" : {
"IncludeBusinessChains": ["Starbucks"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Starbucks",
"Address": {
"Label": "Starbucks, Via Giovanni Giolitti, 2, 00185 Roma RM, Italia",
"Country": {
"Code2": "IT",
"Code3": "ITA",
"Name": "Italia"
},
"Region": {
"Name": "Lazio"
},
"SubRegion": {
"Code": "RM",
"Name": "Roma"
},
"Locality": "Roma",
"District": "Esquilino",
"PostalCode": "00185",
"Street": "Via Giovanni Giolitti",
"StreetComponents": [
{
"BaseName": "Giovanni Giolitti",
"Type": "Via",
"TypePlacement": "BeforeBaseName",
"TypeSeparator": " ",
"Language": "it"
}
],
"AddressNumber": "2"
},
"Position": [
12.50102,
41.90093
],
"Distance": 515,
"Categories": [
{
"Id": "coffee_shop",
"Name": "Coffee Shop",
"LocalizedName": "Bar",
"Primary": true
}
],
"BusinessChains": [
{
"Name": "Starbucks",
"Id": "Starbucks"
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryPosition": [
12.49563,
41.90325
],
"Filter" : {
"IncludeBusinessChains": ["Starbucks"]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position 12.49563 41.90325 \
--filter '{"IncludeBusinessChains": ["Starbucks"]}'
```
------
## Tips Pengembang
+ Anda dapat menggunakan `ExcludeBusinessChains` untuk mengecualikan rantai bisnis tertentu dari hasil Anda.
+ Anda dapat mengecualikan atau menyertakan beberapa rantai bisnis.
# Cara mencari di dekatnya di suatu negara
SearchNearby API memungkinkan Anda untuk mencari tempat terdekat di negara tertentu. Untuk menggunakan API, Anda perlu menyediakan QueryPosition, yang dapat berupa:
+ Posisi perangkat
+ Posisi berbasis IP
+ Pusat viewport peta
Atau, pengguna dapat memberikan nama kota atau tempat, dan aplikasi dapat membiaskan hasil berdasarkan geokoordinat lokasi tersebut.
## Kasus penggunaan potensial
+ Jelajahi bisnis dalam suatu negara
+ Temukan pelanggan B2B terdekat di suatu negara
+ Jelajahi tempat-tempat wisata di suatu negara
## Contoh
### Cari lapangan golf di Kanada
Contoh berikut menunjukkan cara mencari lapangan golf di Kanada dekat koordinat yang ditentukan.
------
#### [ Sample request ]
Permintaan ini mencari lapangan golf di Kanada dekat lokasi yang ditentukan.
```
{
"QueryPosition": [
-122.741803,
49.002478
],
"Filter" : {
"IncludeCategories": ["golf_course"],
"IncludeCountries": ["CAN"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Peace Portal Golf Course",
"Address": {
"Label": "Peace Portal Golf Course, 16900 * Ave, Surrey, BC V*Z *P*, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Surrey",
"District": "South Surrey",
"PostalCode": "V*Z *P*",
"Street": "* Ave",
"StreetComponents": [
{
"BaseName": "4",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "16900"
},
"Position": [
-122.75086,
49.00921
],
"Distance": 998,
"Categories": [
{
"Id": "golf_course",
"Name": "Golf Course",
"LocalizedName": "Golf Course",
"Primary": true
}
],
"Contacts": {
"Phones": [
{
"Value": "+16045384818" }
],
"Websites": [
{
"Value": "http://www.peaceportalgolf.com"
}
]
},
"AccessPoints": [
{
"Position": [
-122.75087,
49.00935
]
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryPosition": [
-122.741803,
49.002478
],
"Filter" : {
"IncludeCategories": ["golf_course"],
"IncludeCountries": ["CAN"]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position -122.741803 49.002478 \
--filter '{"IncludeCategories": ["golf_course"], "IncludeCountries": ["CAN"]}'
```
------
# Cara mencari di dekatnya menggunakan konteks geospasial
SearchNearby API memungkinkan Anda menjelajahi area terdekat, sambil membatasi hasil dalam konteks geospasial (seperti lingkaran atau kotak pembatas).
SearchNearby API memungkinkan Anda memfilter hasil menggunakan konteks geospasial seperti lingkaran dan kotak pembatas. Dengan mendefinisikan batas-batas geografis ini, Anda dapat membatasi hasil pencarian ke area tertentu.
## Kasus penggunaan potensial
+ Batasi hasil pencarian ke area geografis tertentu
+ Cari dalam batas yang ditentukan khusus
+ Fokus hasil pada lingkungan atau distrik yang ditargetkan
## Contoh
### Cari menggunakan radius kueri
Contoh berikut menunjukkan cara mencari sekolah dalam radius 1000 meter dari koordinat yang ditentukan.
------
#### [ Sample request ]
Permintaan ini mencari sekolah dalam radius 1000 meter (1 kilometer).
```
{
"QueryPosition": [
-122.741803,
49.002478
],
"QueryRadius":1000,
"Filter" : {
"IncludeCategories": ["school"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Grace Lutheran Church",
"Address": {
"Label": "Grace Lutheran Church, 702 G St, Blaine, WA 98230-5125, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "WA",
"Name": "Washington"
},
"SubRegion": {
"Name": "Whatcom"
},
"Locality": "Blaine",
"PostalCode": "98230-5125",
"Street": "G St",
"StreetComponents": [
{
"BaseName": "G",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "702"
},
"Position": [
-122.74157,
48.99533
],
"Distance": 795,
"Categories": [
{
"Id": "church",
"Name": "Church",
"LocalizedName": "Church",
"Primary": true
},
{
"Id": "kindergarten_and_childcare",
"Name": "Kindergarten and Childcare",
"LocalizedName": "Kindergarten & Childcare",
"Primary": false
},
{
"Id": "school",
"Name": "School",
"LocalizedName": "School",
"Primary": false
}
]
}
...
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryPosition": [
-122.741803,
49.002478
],
"QueryRadius": 1000,
"Filter": {
"IncludeCategories": ["school"]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position -122.741803 49.002478 \
--query-radius 1000 \
--filter '{"IncludeCategories": ["school"]}'
```
------
## Kiat Pengembang
+ Atau, Anda dapat menggunakan filter kotak pembatas.