View a markdown version of this page

場所の相互参照を取得する方法 - Amazon Location Service

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

場所の相互参照を取得する方法

CrossReferences では、場所のサードパーティーサプライヤー識別子を取得できるため、Yelp や TripAdvisor などの外部システム間での場所の相関関係が可能になります。AdditionalFeatures リクエストパラメータCrossReferencesに を含める必要があります。

想定されるユースケース

  • データエンリッチメント: データベースの場所をサードパーティーのレビュープラットフォームと照合して、評価とレビューを表示します。

  • クロスプラットフォーム相関: 共有サプライヤー識別子を使用して、複数のシステムにレコードをリンク配置します。

Sample request
{ "QueryText": "Canlis Seattle", "BiasPosition": [-122.3321, 47.6062], "AdditionalFeatures": ["CrossReferences"] }
Sample response
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "PointOfInterest", "Title": "Canlis, Seattle, WA, United States", "CrossReferences": [ { "Source": "Yelp", "SourcePlaceId": "canlis-seattle", "SourceCategories": [ { "Id": "100-1000-0000", "Name": "Restaurant" } ] }, { "Source": "TripAdvisor", "SourcePlaceId": "d590427", "SourceCategories": [ { "Id": "100-1000-0000", "Name": "Restaurant" } ] } ] } ] }
cURL
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-text?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "QueryText": "Canlis Seattle", "BiasPosition": [-122.3321, 47.6062], "AdditionalFeatures": ["CrossReferences"] }'
AWS CLI
aws geo-places search-text --key ${YourKey} --query-text "Canlis Seattle" --bias-position -122.3321 47.6062 --additional-features CrossReferences

デベロッパー向けのヒント

  • 相互参照は、ポイントオブインタレスト (POI) の結果でのみ使用できます。

  • すべての場所にクロスリファレンスがあるわけではありません。サプライヤー参照が利用できない場合、 フィールドは省略されます。

  • Source フィールドには、サードパーティーサプライヤーの名前と、そのサプライヤーが使用する識別子SourcePlaceIdが含まれます。

  • 返された識別子を使用するには、サプライヤの API ドキュメントを参照してください。たとえば、Yelp ウェブサイトの Yelp Places API または Tripadvisor ウェブサイトの Tripadvisor Content API を参照してください。