Menelusuri tujuan

Developer Wilayah Ekonomi Eropa (EEA)

A Destination merujuk pada tempat menarik yang signifikan atau lokasi tertentu yang ingin dijangkau atau dituju oleh pengguna. Destination dapat menyertakan informasi seperti titik navigasi, landmark, pintu masuk, dan garis batas bangunan.

Endpoint SearchDestinations Geocoding API memungkinkan Anda mengambil informasi mendetail tentang berbagai tujuan berdasarkan kriteria input yang berbeda, seperti alamat, ID tempat, atau koordinat lintang dan bujur.

Permintaan penelusuran tujuan

Permintaan penelusuran tujuan adalah permintaan HTTP POST ke URL dalam bentuk:

https://geocode.googleapis.com/v4beta/geocode/destinations

Teruskan semua parameter di isi permintaan JSON atau di header sebagai bagian dari permintaan POST. Contoh:

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

Anda dapat menentukan lokasi untuk menelusuri tujuan dengan salah satu dari 3 cara berikut:

  • Alamat
  • ID tempat
  • Koordinat lintang dan bujur

Menelusuri tujuan berdasarkan alamat

Anda dapat menentukan alamat sebagai string yang tidak terstruktur. Geocoding alamat tidak menyelesaikan koordinat lintang dan bujur, atau string tidak terstruktur lainnya yang tidak mewakili alamat. Permintaan yang menggunakan string tersebut tidak didukung dan dapat menyebabkan respons error atau perilaku yang tidak ditentukan. Contoh kueri yang tidak didukung meliputi:

Jenis kueri Contoh
Koordinat lintang dan bujur. Gunakan kueri lokasi sebagai gantinya. "37.422131,-122.084801"
Terlalu banyak konsep atau batasan, seperti nama beberapa tempat, jalan, atau kota dalam satu kueri "Market Street San Francisco San Jose Airport"
Elemen alamat pos tidak ditampilkan di Google Maps "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
Nama bisnis, jaringan, atau kategori yang digabungkan dengan lokasi tempat entitas ini tidak tersedia "Tesco di dekat Dallas, Texas"
Kueri ambigu dengan beberapa interpretasi "Pengantaran pengisi daya"
Nama historis yang tidak lagi digunakan "Middlesex United Kingdom"
Elemen atau maksud non-geospatial "Berapa banyak perahu yang ada di Ventura Harbor?"
Nama tidak resmi atau nama unik "The Jenga"
"The Helter Skelter"
Entitas politik besar (Kota, Negara Bagian, Negara) "New York City"
"California"
"USA"
Rute tanpa alamat tertentu "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

atau sebagai postalAddress:

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

Anda biasanya menggunakan format postalAddress saat memproses komponen alamat yang diambil dalam formulir HTML.

Menelusuri tujuan berdasarkan ID tempat

Anda dapat mengambil tujuan dengan memberikan ID tempat:

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

ID Tempat yang Didukung

Endpoint Tujuan Penelusuran berfungsi paling baik dengan ID Tempat yang merepresentasikan tujuan spesifik yang dapat dinavigasi.

ID tempat untuk jenis seperti establishment, point_of_interest, premise, street_address, dan subpremise umumnya didukung.

ID tempat yang tidak merepresentasikan lokasi terpisah, seperti yang disimpulkan dari rentang alamat (misalnya, "10-20 Main St"), bagian rute tanpa nomor tertentu, atau kode plus tidak didukung.

Untuk memastikan kompatibilitas saat menggunakan Place Autocomplete untuk menemukan ID Tempat, pertimbangkan untuk memfilter hasil menurut jenis. Anda dapat menggunakan parameter includedPrimaryTypes dalam permintaan Pelengkapan Otomatis untuk menyertakan hanya jenis yang didukung yang tercantum di atas:

"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]

Hal ini memastikan bahwa ID Tempat yang ditampilkan oleh Place Autocomplete paling kompatibel dengan metode Search Destinations. Perhatikan bahwa jenis establishment bersifat luas. Meskipun diperlukan untuk mencakup banyak lokasi bisnis, filter ini juga dapat menyertakan hasil Place Autocomplete untuk jenis natural_feature, yang hanya memiliki dukungan terbatas di Tujuan Penelusuran.

Menelusuri tujuan berdasarkan lokasi

Anda dapat menelusuri tujuan dengan memberikan koordinat lintang dan bujur:

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

Menggunakan OAuth untuk membuat permintaan

Geocoding API v4 mendukung OAuth 2.0 untuk autentikasi. Untuk menggunakan OAuth dengan Geocoding API, token OAuth harus diberi cakupan yang benar. Geocoding API mendukung cakupan berikut untuk digunakan dengan endpoint Destinations:

  • https://www.googleapis.com/auth/maps-platform.geocode — Gunakan dengan semua endpoint Geocoding API.

Selain itu, Anda dapat menggunakan cakupan https://www.googleapis.com/auth/cloud-platform umum untuk semua endpoint Geocoding API. Cakupan tersebut berguna selama pengembangan, tetapi tidak untuk produksi, karena merupakan cakupan umum yang memungkinkan akses ke semua endpoint.

Untuk informasi dan contoh selengkapnya, lihat Menggunakan OAuth.

Respons penelusuran tujuan

Respons Tujuan Penelusuran memberikan konteks hiperlokal yang kaya tentang lokasi.

Bagian ini menjelaskan kolom respons utama. Untuk mengetahui detail selengkapnya tentang semua kolom respons, lihat Referensi API.

primary

Tempat utama yang diidentifikasi oleh kueri dalam permintaan.

containingPlaces

Entitas yang lebih besar yang menjadi bagian dari tujuan utama (misalnya, mal yang berisi toko).

subDestinations

Lokasi yang lebih spesifik dalam tujuan utama (misalnya, apartemen di sebuah gedung).

entrances

Objek dalam array entrances[] memiliki kolom berikut:

  • location

    Satu pasangan koordinat lintang/bujur yang menentukan lokasi titik masuk dan keluar ke suatu tempat.

  • entrance_tags[]

    Array tag pintu masuk yang menjelaskan karakteristik pintu masuk. Nilai berikut didukung:

    • "PREFERRED"

      Menunjukkan bahwa pintu masuk ini kemungkinan menyediakan akses fisik ke tempat yang ditampilkan. Tempat dapat memiliki beberapa pintu masuk pilihan. Jika pintu masuk tidak memiliki tag ini, berarti pintu masuk tersebut secara fisik berada di gedung yang sama, tetapi tidak selalu memberikan akses ke tempat tersebut.

      Misalnya, jika tempat yang ditampilkan adalah restoran di pusat perbelanjaan, pintu masuk "PREFERRED" adalah pintu masuk yang menuju ke restoran itu sendiri, sedangkan pintu masuk lain yang ditampilkan adalah pintu masuk lain untuk gedung tersebut, seperti pintu masuk ke restoran lain di pusat perbelanjaan.

      Jika tempat yang ditampilkan adalah bangunan itu sendiri, pintu masuk "PREFERRED" adalah pintu masuk yang mengarah ke bagian "utama" bangunan. Misalnya, di pusat perbelanjaan, pintu masuk "PREFERRED" adalah pintu masuk yang memungkinkan akses ke area lobi utama, tetapi jika pintu masuk hanya memberikan akses ke toko di sisi gedung, pintu masuk tersebut tidak akan menjadi pintu masuk "PREFERRED".

structureType

Jenis struktur yang diwakili oleh tempat ini.

  • POINT

    Lokasi titik.

  • SECTION

    Subbagian bangunan.

  • BUILDING

    Bangunan.

  • GROUNDS

    Area luas yang biasanya berisi beberapa bangunan, seperti kampus universitas, kompleks apartemen, atau mal perbelanjaan.

Kolom navigationPoints dalam respons Geocoding berisi daftar titik yang berguna untuk menavigasi ke tempat tersebut. Secara khusus, titik tersebut harus digunakan sebagai titik awal atau akhir saat merutekan di jaringan jalan dari atau ke tempat tersebut. Setiap titik navigasi berisi nilai berikut:

  • navigationPointToken adalah token yang berisi informasi kontekstual di kolom navigationPoints. Anda dapat mengirim token ini ke API perutean dan navigasi untuk meningkatkan kualitas perutean dan pengalaman sungai di aplikasi Anda. Lihat Merutekan menggunakan token titik navigasi untuk mengetahui informasi selengkapnya.
  • location berisi nilai garis lintang dan bujur titik navigasi. Lokasi ini akan selalu sangat dekat dengan jaringan jalan dan merupakan titik awal atau perhentian yang ideal untuk bernavigasi ke dan dari suatu tempat. Titik sengaja sedikit bergeser dari garis tengah jalan untuk menandai dengan jelas sisi jalan tempat lokasi berada.
  • travelModes adalah daftar mode perjalanan yang dapat diakses dari titik navigasi:
    • "DRIVE" adalah mode perjalanan yang sesuai dengan rute mengemudi.
    • "WALK" adalah mode perjalanan yang sesuai dengan petunjuk jalan kaki.
  • usages adalah daftar penggunaan yang didukung oleh titik navigasi. Penggunaan dapat berupa:
    • "DROPOFF"
    • "PICKUP"
    • "PARKING"

arrivalSummary

Insight berteknologi AI untuk membantu kedatangan. Lihat Ringkasan berteknologi AI.

landmarks

Tempat terdekat yang terkenal untuk membantu pengguna memahami lingkungan sekitar tujuan.

Format respons

SearchDestinations menampilkan SearchDestinationsResponse dalam bentuk JSON berikut:

{
  "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"
          ]
        }
      ]
    }
  ]
}

Parameter yang diperlukan

  • Salah satu dari 3 parameter berikut harus ada dalam permintaan API, yang menentukan alamat, tempat, atau lokasi untuk menelusuri tujuan:
    • addressQuery - alamat yang akan ditelusuri.
    • place - ID tempat yang akan ditelusuri.
    • locationQuery - koordinat lintang dan bujur dari lokasi yang akan ditelusuri.

  • FieldMask

    Tentukan daftar kolom yang akan ditampilkan dalam respons dengan membuat mask kolom respons. Teruskan mask kolom respons ke metode menggunakan parameter URL $fields atau fields, atau menggunakan header HTTP X-Goog-FieldMask. Misalnya, permintaan di bawah hanya akan menampilkan pintu masuk, titik navigasi, dan ID tempat tujuan utama.

      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/destinations

    Tidak ada daftar kolom yang ditampilkan secara default dalam respons. Jika Anda menghilangkan masker kolom, metode akan menampilkan error. Setel mask kolom ke * untuk menampilkan semua kolom. Lihat Memilih kolom yang akan ditampilkan untuk mengetahui detail selengkapnya.

Parameter opsional

  • travelModes

    Menentukan jenis navigationPoints yang akan ditampilkan. Titik navigasi untuk moda transportasi lain akan difilter. Jika travelModes tidak disetel, titik navigasi semua moda transportasi dapat ditampilkan.

  • languageCode

    Bahasa yang digunakan untuk menampilkan hasil.

    • Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini mungkin tidak lengkap.
    • Jika languageCode tidak diberikan, API akan menggunakan nilai default en. Jika Anda menentukan kode bahasa yang tidak valid, API akan menampilkan error INVALID_ARGUMENT.
    • API ini berupaya sebaik mungkin untuk memberikan alamat jalan yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API ini menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan memperhatikan bahasa pilihan. Semua alamat lainnya ditampilkan dalam bahasa pilihan. Komponen alamat semuanya ditampilkan dalam bahasa yang sama, yang dipilih dari komponen pertama.
    • Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan kecocokan terdekat.
    • Bahasa pilihan memiliki sedikit pengaruh pada kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan penampilannya. Geocoder menafsirkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan untuk jenis jalan, atau sinonim yang mungkin valid dalam satu bahasa, tetapi tidak dalam bahasa lain.

  • regionCode

    Kode wilayah sebagai nilai kode CLDR dua karakter. Tidak ada nilai default. Sebagian besar kode CLDR identik dengan kode ISO 3166-1.

    Saat melakukan geocoding alamat, geocoding maju, parameter ini dapat memengaruhi, tetapi tidak sepenuhnya membatasi, hasil dari layanan ke wilayah yang ditentukan. Saat melakukan geocoding lokasi atau tempat, geocoding terbalik atau geocoding tempat, parameter ini dapat digunakan untuk memformat alamat. Dalam semua kasus, parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.

  • placeFilter

    Memungkinkan Anda memfilter hasil penelusuran locationQuery agar sesuai dengan persyaratan Anda, seperti hanya menampilkan tujuan yang berupa bangunan atau hanya tujuan yang memiliki alamat jelas.

    Memfilter menurut perincian struktural

    Filter structureType memungkinkan Anda menentukan jenis struktur yang ditampilkan oleh kueri:

    • Mengisolasi Bangunan: Gunakan "structureType": "BUILDING" untuk menampilkan garis luar bangunan di peta atau mendapatkan detail untuk struktur tertentu.
    • Memahami Kompleksitas: Gunakan "structureType": "GROUNDS" untuk memastikan hasil utama adalah alasan keseluruhan. Hal ini berguna saat membuat kueri untuk area yang lebih luas seperti kampus universitas atau pusat perbelanjaan.
    • Berfokus pada Unit/Bagian: Gunakan "structureType": "SECTION" untuk mengidentifikasi bagian dalam bangunan.

    Memastikan alamat yang berguna

    Tidak semua tempat memiliki alamat tingkat jalan yang jelas. Filter addressability membantu Anda mengontrol kualitas alamat dalam hasil:

    • Mewajibkan Alamat Utama yang Jelas: Untuk memastikan hasil tujuan utama selalu memiliki alamat atau nama tingkat jalan, gunakan "addressability": "PRIMARY". Hal ini berguna untuk tujuan navigasi atau tampilan yang memerlukan alamat yang jelas.
    • Izinkan Alamat di Sub-Tujuan: Jika tempat utama mungkin tidak memiliki alamat, tetapi unit di dalamnya memiliki alamat (seperti apartemen di gedung), "addressability": "WEAK" memastikan bahwa setidaknya tempat utama atau salah satu sub-tujuannya memiliki alamat.
    • Hasil Apa Pun: Jika kehadiran alamat tidak relevan dengan kasus penggunaan Anda, gunakan "addressability": "ANY".
    Contoh: Memfilter Gedung yang Dapat Ditargetkan 
    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

Masukan

Ini adalah endpoint eksperimental Geocoding API. Kami akan sangat berterima kasih atas masukan Anda di geocoding-feedback-channel@google.com.