Cara mencari di sekitar berdasarkan rantai bisnis - Amazon Location Service
Kasus penggunaan potensialContohTips Pengembang

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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, lihatFilter Rantai Bisnis.

Kasus penggunaan potensial

  • Jelajahi bisnis di sekitarnya

  • Perluas bisnis Anda dengan menemukan pelanggan B2B terdekat

Contoh

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": "<Redacted>",
            "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.